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ABSTRACT 


This  Users  Manual  provides  the  information  necessary  for  an  individual 
to  run  all  of  the  programs  that  are  comprised  in  the  Generalized 
Monitoring  Facility  (<31F) .  Program  interrelationships  are  presented, 
as  well  as  a  general  overview  of  the  processing,  input,  and  output 
procedures  for  each  program.  Formats  and  exanples  of  user -controlled 
input  data  and  sample  program  outputs  are  shown  and  explained. 
Additionally,  the  Job  Control  Language  (JCL)  deck  setups  necessary  to 
run  the  programs  are  provided. 

This  manual  supersedes  COmnand  and  Gontrol  Technical  Oenter  CSM  UM 
246-81,  1  May  1981. 
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SECTION  1.  GENERAL 


1.1  Purpose  of  the  Users  Manual 


The  Users  Manual  describes  each  of  the  programs  in  the  Generalized 
Monitoring  Facility  (GMF),  discusses  input  options  required  to  run 
‘  program,  and  provides  sample  outputs  generated  by  each  program. 


Generalized  Monitoring  Facility  is  delivered  on  a  FILSYS  SAVE 
.  A  description  of  the  software  is  presented  in  section  2. 
allation  procedures  for  the  GMF  Monitor  and  guidance  on  how  to  run 
car.  be  found  in  section  5  of  this  manual. 


1.2  Project  References 

Hie  Generalized  Monitoring  Facility  was  originally  developed  for  the 
Government  by  Honeywell  Information  Systems.  Since  delivery  of  the 


conpleted  software  in  1975,  the  Computer  Performance  Evaluation  Branch 
(C751)  of  the  Command  and  Control  Technical  Oenter  has  extensively 
modified  and  rewritten  the  GMF  system.  Numerous  software  errors  have 
been  corrected  and  many  new  features  hive  been  added. 

1. 3  Terms  and 

Abbreviations 

The  following  abbreviations  will  be  used  throughout  the  document. 

CAM 

- 

Communications  Analysis  Monitor 

CM 

- 

Channel  Monitor 

CPU 

Central  Processing  Unit 

CPUM 

- 

CPU  Monitor 

GCDS 

- 

Generalized  Comprehensive  Operating  System 

GMC 

- 

Generalized  Monitoring  Collector 

GMF 

- 

Generalized  Monitoring  Facility 

GRTS 

- 

General  Remote  Terminal  Supervisor 

GRIM 

- 

GRTS  Monitor 

IDLEM 

— 

Idle  Monitor 
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MSM  -  Hass  Storage  Monitor 

MUM  -  Memory  Utilization  Monitor 

RfC  -  Resource  Monitor  Collector 

RMDRx  -  Resource  Monitor  Data  Reduction  Program  1  through  3 
RHON  -  Resource  Monitor 


TM  -  Tape  Monitor 

TPEM  -  Transaction  Processing  Executive  Monitor 

WWMCCS  -  World  Wide  Military  Command  and  Control  System 


Security  and  Privacy 


There  are  no  classified  data  collected  in  the  GMF,  but  there  is  one 
exception.  If  the  Communications  Analysis  Monitor  (CAM)  is  being  run 
with  the  Specific  Terminal  Option,  classified  data  may  be  collected. 


1.5  Manual  Format 


Section  2  of  this  Manual  provides  an  overview  of  the  GMF  system.  A 
brief  description  of  each  program  is  included.  Sections  3  through  12 
describe  the  programs  of  the  GMF  system  In  detail.  In  the 
presentation  the  user  will  find  the  appropriate  information  to 
successfully  operate  each  program.  The  format  of  the  sections 
includes  a  discussion  of  each  program  in  the  input,  processing,  and 
output  phases.  Section  13  of  the  document  describes  the  procedures 
that  a  user  should  follow  if  It  is  desired  to  create  a  new  GMF  monitor 
and  section  14  provides  detailed  information  as  to  how  GMF  should  be 
used  in  conducting  a  complete  system-wide  evaluation. 
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SECTION  2.  SYSTEM  SUMMARY 


2.1  System  Application 

This  section  explains  the  GMF  system  by  logically  grouping  the 
programs  into  two  subsystems,  the  Gene rail  Monitor  Collector  (GMC) 
subsystem  and  the  Resource  Monitor  Collector  (RMC)  subsystem. 

Overviews  of  the  programs  in  both  subsystems  are  provided.  The 
purpose  of  the  CMC  subsystem  is  to  provide  a  means  of  collecting 
detailed  information  on  the  operation  of  the  operating  system  and  on 
the  flow  of  a  job  through  the  system.  The  purpose  of  the  RMC 
subsystem  is  to  provide  a  general  view  of  the  operation  of  the 
system.  The  RMC  can  be  run  on  a  daily  basis  to  allow  the  continuous 
analysis  of  the  system  operation.  When  it  appears  a  problem  is 
occurring,  the  GMC  can  be  run  to  further  define  and  resolve  the 
problem  area. 

2. 2  System  Operation 

Both  GMC  and  RMC  monitor  GCOS  in  real  time  and  generate  output  tapes. 
These  output  tapes  are  then  processed  through  a  series  of  data 
reduction  routines  which  produce  histograms,  graphs,  and  reports  which 
allow  an  analyst  to  evaluate  system  performance.  Both  RMC  and  QIC 
have  exclusive  data  reduction  routines  (i.e.,  a  tape  generated  by  RMC 
cannot  be  reduced  by  the  CMC  data  reduction  program).  Differences 
between  the  (MC  and  RMC  subsystems  pertain  to  the  methods  used  to 
collect  measurement  data. 

The  RMC  is  a  sampling-based  monitor.  At  30-second  intervals,  the  RMC 
enters  execution  and  collects  its  data.  Since  it  samples  only  at 
preselected  intervals,  it  cannot  present  a  complete  history  of  what 
has  occurred  on  the  system.  However,  because  the  RMC  is  a 
sampling -based  monitor,  overhead  is  lew. 

The  (MC  is  a  trace-based  monitor.  The  various  monitors  that  are 
comprised  in  the  CMC  subsystem  are  called  into  execution  by  the 
occurrences  of  the  events  that  are  to  be  captured.  The  GMC  can 
therefore  be  used  to  provide  a  caiplete  and  detailed  history  of  system 
performances. 

Because  all  occurrences  of  a  given  event  are  retrieved,  GMC  overhead 
is  higher  than  RMC.  Unlike  the  RMC,  CMC  must  be  locked  into  core. 

2.2.1  The  Resource  Monitor  Collection  (RMC)  Subsystem.  The  RMC 
subsystem  is  composed  of  a  data  collector,  RMC,  and  three  associated 
data  reduction  routines.  The  RMC  is  explained  in  section  3,  and  the 
RMC  data  reduction  routines  are  discussed  in  section  4. 

The  RMC  is  a  sampling-based  monitor.  The  RMC  will  sample  system 
queues  and  tables  on  a  30-second  time  interval.  The  data  captured 
from  these  queues  and  cells  are  written  to  the  system  accounting  file. 


The  output  generated  by  the  RMC  is  irput  to  a  series  of  three  data 
reduction  routines.  Sample  report  output  from  these  data  reduction 
routines  can  be  found  in  subsection  4.3.  See  figure  2-1  for  the  RMC 
system  flowchart  and  figure  2-2  for  the  subroutines  that  comprise  the 
RMC  system. 

2.2.2  The  Generalized  Monitor  (QIC)  Subsystem.  The  GMC  subsystem  is 
composed  of  a  series  of  data  collector  programs  and  a  related  set  of 
data  reduction  programs.  Each  data  collector  program  consists  of  one 
or  more  subroutines,  and  each  program  is  used  to  monitor  a  different 
area  of  system  performance.  The  name  of  the  program  indicates  the 
area  of  system  performance  measured.  In  addition,  any  combination  of 
monitoring  programs  may  be  executed  during  a  monitor  session.  A 
detailed  description  of  the  entire  data  collector  facility  is  given  in 
section  5.  Figure  2-3  shows  the  interrelation  of  all  programs  within 
the  GMC  subsystem.  Figure  2-4  shows  the  subroutines  that  coirprise 
each  data  collector  program  and  those  trace  types  which  need  to  be 
active  for  each  subroutine. 

The  mechanism  used  by  the  GMC  data  collector  for  obtaining  control 
from  the  operating  system  is  that  of  the  normal  system  trace.  The 
trace  records  a  history  of  the  occurrence  of  one  or  more  of  72  systems 
events,  65  of  which  are  presently  defined.  This  recording  is  done  by 
the  system  executing  a  unique  code  set  resident  in  the  System 
Dispatcher  Module  ( .MDISP) .  Execution  of  this  code  is  conmon  to  all 
system  trace  events  and  provides  the  point  at  which  the  GMC  obtains 
control.  See  section  5  for  a  detailed  description  of  how  GMC  gains 
control  from  the  system. 

The  executive  routine  of  the  GMC  processes  input  cards  for  the  data 
collection  routines  determines  which  areas  of  the  system  are  to  be 
monitored,  performs  any  necessary  initialization,  and  controls  all 
data  buffering  and  tape  writing.  A  detailed  description  of  this 
routine  is  given  in  section  5.  The  associated  GMC  data  reduction 
programs  are  described  in  sections  6  through  12. 

2.3  System  Oonf iguration 

The  GMF  is  designed  to  be  run  on  a  HIS  6000  computer  system,  running 
with  WWMOCS  GCDS  release  6.4  or  7.2.  These  releases  are  equivalent  to 
the  HIS  commercial  2H  or  4JS  (any  level)  GCDS  releases.  When  OIC  is 
used  on  WWMCCS  release  7.2,  or  commercial  release  4JS  (any  level),  the 
user  must  insure  that  the  value  for  variable  *SYS64"  is  changed  from 
its  current  value  of  1  to  a  value  of  0.  See  subsection  2.6  for  a 
complete  description  of  all  user  requirements  prior  to  using  the  GMC. 
When  RMC  is  used  on  WWMCCS  release  7.2,  or  commercial  release  4JS  (any 
level),  the  user  must  insure  that  the  value  for  variable  "W6. 4*  is 
changed  from  its  current  value  of  1  to  a  value  of  0.  See  subsection 
3.3.1  for  details  of  this  requirement. 
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RMC  EXECUTIVE  SOUTINE 


WRITE  TO 

ACCOUNTING 

FILE 


Figure  2-2. 


Program  In  the  RMC  Subsystem 
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Figure  2-3.  Programs  in  the  GMC  Subsystem 


Data  Collector 


Programs 

Subroutines 

Traces  Captured 

Memory  Utilization 

T10 

10,11,51 

Monitor 

T46 

46 

Idle  Monitor 

T21 

21 

TRCS 

0,1,2,3,13,16,22 

37,65 

Mass  Store  Monitor 

77 

7, 15, 73*, 76*, 77* 

Channel  Monitor 

T4 , 77 ,  T2  2 

4,7,15,22 

Tape  Monitor 

150 

50,51,52 

CPU  Monitor 

770 

10,11,21,70* 

Communications  Analysis 
Monitor 

T14 

14* 

GETS  Monitor 

T62 

62* 

TPE  Monitor 

T200 

0,1,2,4,5,6,13, 

42,51,65,74* 

-  Nonstandard  traces  generated  by  the  particular  monitor. 


Figure  2-4.  Subroutines  and  Traces  in  GMC  Data 
Collector  Programs 
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2.4  System  Organization 

The  OIF  is  composed  of  two  data  collectors,  CMC  and  RMC,  and 
associated  data  reduction  programs.  Sections  3  through  12  describe 
these  programs.  Figure  2-1  gives  a  system  flowchart  for  the  RMC. 
Figure  5-1  gives  a  system  flowchart  for  the  CMC. 

2.5  Performance 


The  GMF  monitors  the  performance  of  a  system,  aids  in  identifying  the 
start  of  system  performance  problems,  and  aids  in  analyzing  system 
performance  problems.  The  RMC  requires  very  little  system  resource 
usage  and  writes  all  its  data  to  the  system  accounting  file.  The  CMC 
is  a  much  more  detailed  system  with  the  associated  higher  overhead. 
The  CMC  is  used  mainly  to  determine  the  cause  of  system  performance 
problems.  The  GMC  requires  15  to  24  thousand  words  of  memory  and  one 
tape  drive  while  being  run.  Both  systems  require  offline  data 
reduction. 

2.6  CMF  Installation 


2.6.1  Creation  of  OIF  Files.  The  GMF  software  is  contained  on  a 
single  user  save  tape.  The  USERID  on  the  tape  is  B29IDPX0.  This 
USERID  must  be  created  with  4200  LLINKS  of  file  space.  A  user  restore 
can  then  be  run.  B29IDPX0  is  subdivided  into  several  catalogs 
described  below: 

.  GMFCDL  -  685  LLINKS  -  This  subcatalog  contains  all  the  data 
collection  software  for  the  GMC  monitoring  system.  All  files  within 
this  subcatalog  are  completely  described  in  section  5. 

.  SOURCE  -  1850  LLINKS  -  This  subcatalog  contains  Time  Sharing 
source  files  for  all  data  reduction  programs  contained  within  the  GMC 
system.  Figure  2-5  is  a  breakdown  of  the  individual  files  within  this 
subcatalog.  Sections  6-12  describe  each  program  in  detail. 

.  OBJECT  -  1010  LLINKS  -  This  subcatalog  contains  the  object  decks 
for  all  the  data  reduction  programs  contained  within  the  GMC  system. 
Figure  2-5  is  a  breakdown  of  the  individual  files  within  this 
subcatalog. 

.  JCL  -  18  LLINKS  -  This  subcatalog  contains  all  the  JCL  required 
to  run  all  the  data  reduction  programs  contained  within  the  GMC 
system.  Figure  2-6  is  a  breakdown  of  the  individual  files  within  this 
subcatalog. 

.  RMON  -  345  LLINKS  -  This  subcatalog  contains  all  the  software 
required  to  collect  and  reduce  the  data  for  the  RMON  Monitoring 
system.  This  subcatalog  is  further  subdivided  into  JCL,  SOURCE  and 
OBJECT  subcatalogs.  The  files  within  these  subcatalogs  are  completely 
described  in  sections  3  and  4. 
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FILE  NAME 


FUNCTION 


SOURCE 
SIZE  (LL) 


OBJECT 
SIZE  (LL) 


MUM  MEMORY  UTILIZATION  MONI-  355  207 

TOR  DATA  REDUCTION  PRO-. 

GRAM.  REFERENCED  IN 
CHAPTER  6. 

MSM  MASS  STORE  MONITOR  DATA  295  160 

REDUCTION  PROGRAM. 

REFERENCED  IN  CHAPTER  7. 

CM  CHANNEL  MONITOR  DATA  250  170 

REDUCTION  PROGRAM. 

REFERENCED  IN  CHAPTER  8. 

CAM  COMMUNICATION  MONITOR  DATA  165  85 

REDUCTION  PROGRAM. 

REFERENCED  IN  CHAPTER  9. 

CPU-TAPE  CPU  AND  TAPE  MONITOR  389  160 

DATA  REDUCTION  PROGRAMS. 

REFERENCED  IN  CHAPTER  11. 

GRT  DATANET  355  MONITOR  DATA  280  142 

REDUCTION  PROGRAM. 

REFERENCED  IN  CHAPTER  10. 

TP  ETC  TRANSACTION  PROCESSING  64  60 

DATA  REDUCTION  PROGRAM. 

REFERENCED  IN  CHAPTER  12. 

TPEALT  AN  ALTER  FILE  FOR  ADDING  14 

TPE  TRACE  CODE  INTO  THE 
TPE  SUBSYSTEM  (NO  OBJECT 
FILE).  REFERENCED  IN 
CHAPTER  12. 

TPEDUMP  A  PROGRAM  FOR  OBTAINING  A  38  26 

FORMATTED  TRACE  DUMP  FROM 
A  TPE/GMF  DATA  TAPE. 

REFERENCED  IN  CHAPTER  12. 


Figure  2-5.  B29 IDPX0/ SOURCE  and 

B29 IDPX0/OBJE3CT  Catalog  Structure 
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FILE  NAME 


FUNCTION 


SOURCE 
SIZE  (LL) 


MUM  JCL  TO  OBTAIN  ALL  MEMORY  2 

UTILIZATION  MONITOR 
REPORTS 

MSM  JCL  TO  OBTAIN  MASS  2 

STORE  MONITOR  REPORTS 

CM  JCL  TO  OBTAIN  CHANNEL 

MONITOR  REPORTS 

CAM  JCL  TO  OBTAIN  COMMUNI-  2 

CATION  MONITOR  REPORTS 

CRT  JCL  TO  OBTAIN  PN-355  2 

MONITOR  REPORTS 

CPU  JCL  TO  OBTAIN  CPU  MONITOR  2 

REPORTS 

TAPE  JCL  TO  OBTAIN  TAPE  2 

MONITOR  REPORTS 

TPETG  JCL  TO  OBTAIN  ALL  REPORTS  2 

FROM  THE  TPE  DATA 
REDUCTION  PROGRAM 

TPEDUMP  JCL  TO  OBTAIN  ALL  REPORTS  14 

FROM  THE  TPE  FORMATTED 
TRACE  DUMP  PROGRAM 


L  ; 


Figure  2-6.  B29IDPXO/JCL  Catalog  Structure 
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2.6.2  GMF  Release  Dependent  Parameters.  In  order  for  the  GMC  to 
operate  properly,  it  is  necessary  for  GMC  to  locate  certain 
instructions  and/or  words  within  several  system  programs.  The  user 
should  insure  that  these  locations  are  correct  for  the  particular  GCOS 
release,  under  which  he  is  operating.  Table  2-1  is  a  list  of  these 
dependent  parameters  identifying  their  the  use  and  providing  the 
approximate  program  source  line  numbers  where  the  particular 
parameters  are  used.  The  list  is  provided  for  each  GMC  program  that 
must  checked  by  the  user. 

In  order  to  use  the  GMC  data  reduction  programs  on  a  WW6.4  system, 
there  is  a  special  data  card  required  in  certain  programs.  This 
option  applies  to  all  data  reduction  programs  except  CPU-TAPE  and 
TP ETC.  The  TP  ETC  program  is  not  designed  for  use  under  any  release 
other  than  WW7.2.  The  CPU-TAPE  program  would  require  a  one-line 
source  change  to  be  used  under  a  WW6.4  release. 

The  GMC  system  is  designed  so  that  data  collected  on  a  WW6.4  system 
may  be  reduced  under  a  WW6.4  system  or  a  WW7.2  system.  In  addition, 
data  collected  under  a  WW7.2  system  may  likewise  be  reduced  under  a 
WW7.2  system,  or  a  WW6.4  system.  Whenever  the  data  reduction  programs 
for  MUM,  CM,  CAM,  or  GRT  are  used  on  a  WW6.4  system,  a  data  card  with 
an  RN  typed  on  it  must  be  included  in  the  input  section  of  the  JCL 
deck.  It  makes  no  difference  under  what  release  the  data  was 
collected.  It  is  only  a  question  of  under  what  release  the  data  is 
being  reduced. 


For  the  MSM  data  reduction  program,  there  are  two  data  cards 
required.  The  first  data  card  always  contains  the  letters  RN.  The 
second  card  is  determined  by  the  following  table: 


Data  Collected 

WW6.4 

WW6.4 

WW7.2 

WW7.2 


Data  Reduced 

WW6.4 

WW7.2 

WW6.4 

WW7.2 


Data  Value 

1 

3 

2 

NO  SPECIAL  CARDS 
REQUIRED 


For  the  CPU-TAPE  data  reduction  program,  it  is  required  to  delete 
source  line  #4320  and  recompile  when  using  the  data  reduction  program 
under  a  WW6.4  release. 


The  RMC  System  is  also  designed  to  run  under  GCOS  release  WW6.4.2 
(conmerical  release  2H),  or  WW7.2  (commercial  release  4JS  (any 
level)).  See  subsection  3.3.1  for  details  as  to  required 
modifications. 
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Table  2-1.  CMC  Release  Dependent  Parameters 


Program  LINE  # 

Gf-f  .TOP  90 


10220 


10700 


CPU. PAT  10 
210 
230 
420 


720 

740 

1460 

1480 


1190 


Variable  Explanation 


SVS64  Used  to  control  conditional  assembly 

of  GMC  set=l  for  W6.4(2H)  release 
set=0  for  W7.2(4J)  release 

Code  in  this  area  searches  for  trace 
processing  within  the  dispatcher. 

Trace  code  must  be  within  500  octal 
locations  of  the  address  specified  by 
entry  pt  15  decimal  of  the  dispatcher. 
The  code  being  searched  for  is  a 
LDAQ; STAQ;TRA0, 1 

Code  in  this  area  is  used  to  make  a 
correction  to  accounting  processing, 
if  the  correction  has  not  already 
been  made  via  patches.  The  code  is 
searched  for  within  500  octal  loca¬ 
tions  of  .MIOS  entry  point.  The  code 
searched  for  is  SBLA  TRREG+7,$;ARl  12; 
ADLA  ,CRT0D,7.  The  ARL  is  changed  to 
an  ARS. 

Code  in  this  area  searches  for  an  ASA 
•SALT, 5  Instruction  in  the  dispatcher. 
In  W6.4  search  octal  locations  1500- 
1700.  In  W7.2  search  octal  locations 
2340-2450.  In  addition  in  W7.2  we 
need  to  find  a  STQ  ,0T0D,4  instruction 
between  octal  locations  2400-2460. 

For  both  releases  we  need  to  find  8 
words  of  patch  space.  In  W6.4 
between  octal  locations  3540-3740. 

In  W7.2  between  octal  locations 
4600-5000.  If  not  found  here  then 
search  octal  locations  4150-4300  in 
W6.4  or  octal  locations  5400-5530  in 
W7.2.  In  addition  .ntalt  is  searched 
in  W7.2  for  an  ARL  12  instruction 
between  octal  locations  2500-2550. 

This  is  for  gate  locked  timing  code 
which  is  supposed  to  be  assembled 
into  W7.2  code. 


♦ 
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Program 


LINE  t 


Variable  Explanation 


CAM. PAT  10 

140 

370 

720 

740 

MSM.PAT  10 

390-680 


850 

870 

1320 

1340 


GMF.MON  840  FMS1 


850  FKS2 


Code  in  this  area  searches  for  a  LDQ 
M.LID,3  instruction  in  DNWW,  followed  by  a 
ANQ=O077777,OU  instruction.  Octal 
locations  5000-6000  are  searched.  Ten 
words  of  patch  space  must  be  obtained. 

This  patch  space  must  be  between  octal 
locations  11020  and  11160.  If  patch  space 
is  not  found  then  7  words  of  patch  space 
are  searched  for  within  the  dispatcher. 
This  search  is  performed  between  octal 
locations  3540-3740  in  W6.4  and  octal 
locations  4600-5000  in  W7.2.  It  should  be 
noted  that  in  commercial  releases  and 
WW7.2,  DNWW  is  referred  to  as  DNET. 

Code  in  this  area  searches  for  an  AOS 
•CRTDL  instruction  and  an  AOS  .CRTBH 
instruction  in  the  dispatcher.  In  W6.4 
and  W7.2,  these  need  to  be  within  300 
octal  locations  of  the  label  DBASE.  If 
these  instructions  are  not  found,  a  search 
is  made  from  octal  locations  4600-5100  in 
W6.4  and  octal  locations  7164-7464  in 
W7.2.  In  addition,  8  words  of  patch  space 
is  needed.  In  V6.4  between  octal 
3540-3740.  In  ',<7.2,  between  octal 
4600-5000.  If  the  patch  space  is  not 
found  then  search  between  octal  locations 
4150-4300  in  W6.4,  or  octal  5400-5530  in 
W7.2.  In  addition  in  W7.2  FMS  CACHE  logic 
is  also  analyzed.  See  label  TSFIO  in 
routine  T7  for  locations  required  within 
FSIO  module. 

Offset  from  entry  point  of  .MFSIO  which 
points  to  the  word  giving  the  absolute 
address  of  FMS  catalog  cache  buffer.  Used 
only  in  W7.2.  Set  to  -13  decimal. 

Offset  from  entry  point  of  .MFSIO  pointing 
to  the  work  which  gives  the  option 
selection  for  FMS  catalog  cache.  Used 
only  in  W7.2.  Set  to  -15  decimal. 
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Ptoqram  LINE  0  Variable 

MUM. T 10  220  SYS64 

920  FIFO 


5280 

XPQ24 

5290 

SLVSNB 

5300 

N€MUSE 

5310 

IDENT 

Explanation 
See  G^F.TOP 

Address  of  the  FIFO  buffer  within 
PALC.  It  is  used  to  search  the  XT 
table  of  PALC.  It  is  set  to  113  octal. 
This  includes  adding  in  a  110  octal 
offset  for  the  loading  of  PALC  in 
W6.4.  There  is  no  PALC  offset  in  W7.2. 

Location  in  CALC  of  the  memory  demand 
table.  Set  to  octal  111. 

Offset  in  slave  prefix  area  of  job 
SNUMB.  Set  to  octal  36. 

Offset  in  slave  prefix  area  of  loader 
memory  use  word.  Set  to  octal  37. 
Offset  in  slave  prefix  area  of  job 
IDENT.  Set  to  octal  66. 


CPU.T70 

120 

SYS64 

See  GI-F.TOP 

CM.T07A 

180 

IDENT 

Offset  in  slave  prefix  area  of  job 
ident.  Set  to  octal  66. 

200 

SYS64 

See  GMF.TOP 

8990 

This  area  of  code  searches  .hfSIO  in 
W7.2  to  gather  statistics  for  FMS 
catalog  cache  processing.  Code  should 
be  checked  to  assure  correct  addresses 
are  checked. 

10340 

FFCCC 

Address  in  PALC  where  the  file  code  is 
stored  during  GEFSYE  processing. 

Set  to  6177  octal  in  W6.4  and  13143 
octal  in  W7.2.  This  includes  110 
octal  for  loading  of  PALC  in  W6.4. 

10350 

SNUMBP 

Address  in  PALC  where  the  SNUMB  is 
stored  during  GEFSYE  processing.  Set 
to  35012  octal  in  W6.4  and  2632  octal 
W7.2.  This  includes  110  octal  for 
loading  of  PALC  in  W6.4 

10360 

ACT 

Address  in  PALC  where  the  activity 

number  is  stored  during  GEFSYE 
processing.  Set  to  33231  octal  in 
W6.4  and  1051  octal  in  W7.2.  This 
includes  110  octal  for  loading  of 
PALC  in  W6.4.  There  is  no  offset 
for  PALC  in  W7.2. 
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SECTION  3.  RESOURCE  MONITOR  COLLECTOR 


3.1  Introduction 

The  RMC  is  a  privileged  software  package  which  periodically  samples 
the  system  programs,  queues,  counters,  and  tables  of  GCDS.  The  RMC 
consists  of  initialization  routines,  general  purpose  routines,  and 
three  discrete  data  collector  routines,  named: 

°  Program  collector 
°  Peripheral  collector 
0  Software  collector 

Each  of  the  data  collectors  generates  a  unique  record  format  in  one  of 
the  common  buffer  areas.  A  .CALL  to  .MSCF,2  is  made  to  write  each 
record  to  the  system  accounting  file. 

3.2  RMC  Input  Options  and  JCL 

There  are  currently  no  RMC  user  input  options.  The  JCL  needed  to 
execute  the  RMC  is  shown  in  figure  3-1.  Since  the  RMC  runs  in  master 
mode,  it  requires  a  $  PRIVITY  card,  meaning  the  operator  must  GRANT 
the  job.  The  RMC  requires  a  SNUMB  of  RMON  to  run.  The  program  checks 
to  insure  this  SNUMB  is  present  or  else  it  will  abort  with  a  R1  abort. 

3.3  Processing 

The  RMC  requires  no  special  tapes  or  disk  files.  All  data  is  written 
to  the  Statistical  Collection  File  (SCF).  The  RMC  will  swap  out  of 
core  if  required  and  produce  low  system  overhead.  The  next 
subsections  discuss  the  collection  routine  of  the  RMC  and  give  the 
record  formats. 

3.3.1  Oollection  Routine.  The  RMC  collection  routine  is  a  GMAP 
program  requiring  PRIVITY.  As  currently  released,  the  program  uses 
SCF  record  number  609  for  its  data  record.  The  user  may  alter  the 
source  file  to  collect  other  than  609  record  data.  The  procedure  is 
to  alter  line  230  in  B29IDPXO/RMON/SOURCE/64CDL  to  read  .  .  .  EQU  NNN, 
where  NNN  is  a  new  record  number.  The  same  change  must  be  done  at 
line  140  in  file  B29 IDPXO/RMON/SOURCE/RMDR1 .  RMC  is  designed  to  run 
under  GCOS  release  WW6.4.2  {commercial  release  2H),  or  WW7.2 
(commercial  release  4J  (any  level)).  TP  collect  data  for  system 
release  W7.2  (commercial  release  4J  (any  level))  source  line  220  in 
640DL  must  be  altered  to  EQU  0,  as  well  as  source  line  130  in  RMDRl. 

If  RMC  is  to  be  run  on  a  commercial  system,  additional  changes  must  be 
made.  In  B29IDPX0/RMON/64ODL,  code  located  at  TSS  line  numbers 
641-649,  and  5761-5764  should  be  compiled  (delete  *  from  beginning  of 
line).  In  the  same  file,  lines  2440,  2460  and  2480  should  be 
deleted.  Lines  2441,  2461  and  2481  should  be  conpiled  (*  deleted). 
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$  OPTION  NOSETU 

$  LOW.OAD  LSW 

$  N0LI8 

$  SELECT  B29IDPXO/RMON/OBOECT/64COL 

$  EXECUTE  DUM3 

$  LIMITS  999, 4K„  500 

$  PRIVITY 


$  ENDJOB 


The  RMC  writes  three  type  609  records  every  30  seconds.  The  type  609 
record  consists  of  one  of  three  subtypes.  These  subtypes  are  a 
maximum  of  210  words  with  the  maximum  size  dependent  upon  the 
configured  system  size.  The  RMC  initially  insures  that  its  SNUMB  is 
RMON.  This  insures  only  one  copy  of  RMQN  is  running  at  any  time.  The 
RMC  then  initializes  its  tables  according  to  the  system 
conf iguration.  Extended  memory  instructions  are  NQPed  if  required  and 
any  excess  memory  is  released.  The  RMC  then  processes  each  of  its 
record  types  every  30  seconds. 

The  following  procedure  applies  to  the  WWMCCS  software  releases.  The 
user  should  insure  that  the  600  class  of  SCF  records  have  been  turned 
on  for  his  system.  He  must  check  two  different  places.  First,  the 
$SCFBUF  card  in  the  boot  deck  must  contain  at  least  a  C6  to  indicate 
collection  of  600  level  SCF  records.  The  user  should  then  enter  the 
command  SCFRST  609  at  the  system  console.  The  system  should  respond 
with:  609/AC  to  indicate  that  the  records  are  being  collected. 

The  user  must  next  insure  that  the  system  MASK  cards  are  defined 
correctly.  The  600  class  SCF  records  must  be  turned  on  in  INIT  by  use 
of  a  MASK  card  in  the  boot  deck.  The  location  to  be  patched  with  the 
MASK  card  is  RMAX+6  in  INIT.  The  location  should  be  patched  with  the 
following  octal  patch 

COL  1  8 

OCTAL  MASK 

LOCATION 
OF  RMAX+6 

This  patch  allows  10  type  600  SCF  records  to  be  collected  (600-609). 
These  same  procedures  should  be  followed  by  the  user  if  he  also 
changes  the  RMON  SCF  record  number.  Commercial  4Jx  sites  should  check 
the  System  startup  Manual  for  procedures  on  defining  new  SCF  record 
types. 
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3. 3. 1.1  Program  Data  -  Subtype  1.  This  data  type  contains  overhead 
and  idle  times  for  all  configured  processors,  size  of  memory,  number 


of  processors,  and  number  of  TSS 
examined  and  its  status  is  saved 


WORD 

BITS 

1 

0-17 

18-35 

2-13 

0-35 

14 

0-17 

18-35 

15 

0-17 

18-35 

users.  Bach  job  in  the  system  is 
The  subtype  1  record  format  is: 

CONTENT 

Size  (210  words  max) 
record  type 

Standard  SCF  header 

Zero 

1  (subtype) 

Number  of  TSS  users 
Available  memory 
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16-18 


0-35 


Not  Used 


19 

0-35 

Overhead  time  (.CROVH) 

20 

0-35 

Idle  time  (.CRIDT) 

21 

0-17 

Number  of  processors 

18-35 

Oonf igured  memory  ( . CRMSZ ) 

22 

0-29 

SNUMB 

30-35 

Reserved 

23 

0-17 

Status  from  .CRSN1 

18-35 

Memory  size  if  in  memory 

24 

0-35 

Accumulated  processor  time 

22-24  are  repeated  for  all  jobs  in  the  system. 

3. 3. 1.2  Peripheral  Data  -  Subtype  2.  This  data  type  consists  of 
channel  use  time  for  each  channel,  device  status  (released,  assigned, 
dedicated,  permanent,  removable),  and  capacity  of  disk  packs.  The 
subtype  2  record  format  is: 

WORD  BITS  CONTENT 


1 

0-17 

Size  (210  words  max) 

18-35 

Record 

2-13 

0-35 

Standard  SCF  header 

14 

0-17 

Zero 

18-35 

2  (subtype) 

15 

0-17 

Number  of  IOMs 

18-35 

Available  links  of  mass  storage 

16-18 

0-35 

Not  used 

19 

0-5 

Translated  device  code 

6-11 

Reserved 

12-17 

Number  free  devices 

18-23 

Number  allocated  devices 

24-29 

Number  dedicated  devices 

30-35 

Number  released  devices 

20 

12-35 

Offset  for  channel/device  status 
counts 

21 

0-35 

Channel  use  time 

words  19  and  21  are  repeated  for  each  channel. 
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3. 3. 1.3  Software  Data  -  Subtype  3.  This  data  type  consists  of  system 
scheduler  data,  number  of  jobs  swapped,  number  of  jobs  moved,  number 
of  memory  compactions,  and  number  of  activities.  The  subtype  3  record 
format  is: 


WORD 

BITS 

03NTENT 

1 

0-17 

Size  (81  words  max) 

18-35 

Record  size 

2-13 

0-35 

Standard  SCF  header 

14 

0-17 

Zero 

18-35 

3  (subtype) 

15 

0-17 

Flag,  0  if  scheduler  swapped 

18-35 

Reserved 

16-18 

0-35 

Reserved 

19-70 

0-35 

Scheduler  class  data 

71 

0-35 

Number  of  activities 

72 

0-35 

Number  of  connects 

77 

0-35 

Number  of  dispatches 

74 

0-35 

Number  of  interrupts 

75 

0-35 

Number  of  new  jobs 

76 

0-35 

Number  of  jobs  moved 

77 

0-35 

Number  of  jobs  swapped 

78 

0-35 

Number  of  memory  compacts 

79 

0-35 

Number  of  remote  jobs 

80 

0-35 

Number  of  swaps 

81 

0-35 

Number  of  times  processor  went 

3.4  Outputs 

The  RMC  writes  all 

its' output 

to  the  SCF. 
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3.5  Abort  Codes 


The  RMC  can  abort  with  one  of  the  following  aborts: 

Snumb  not  RMON 
RMON  not  lcwloaded 

Internal  Peripheral  Table  Overflowed  (call  CCTC,  C751) 
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SECTION  4.  RESOURCE  MONITOR  DATA  REDUCTION 


The  Resource  Monitor  Data  Reduction  (RMDR)  is  composed  of  three 
discrete  programs.  The  first  program  (RMDRl)  processes  the  raw  SCF 
tape  to  gather  the  RMC  records.  The  next  program  (RMDR2)  processes 
the  RMC  records,  sorts,  and  reformats  them.  The  last  program  (RMDR3) 
prints  out  the  required  plots.  Figure  4-1  is  an  overview  of  the  RMDR. 

4.1  RMDR1 


RMDRl  reads  the  raw  SCF  data,  selects  out  the  RMC  data,  analyzes  it, 
prints  results,  sorts  it,  and  passes  it  to  the  RMDR2. 

4.1.1  RMDRl  Inputs.  The  RMDRl  program  requires  one  input  (SCF  data) 
and  has  one  optional  input  (System  SNUMB  list). 

4. 1.1.1  RMDRl  -  SCF  Data  (File  RM) .  This  input  is  the  raw  accounting 
data  containing  the  Resource  Monitor  data. 

4.1.1. 2  RMDRl  -  System  SNUMB  (File  MF).  The  RMDRl  contains  an 
internal  System  SNUMB  list.  This  list  is  a  collection  of  all  SNUMBs 
in  the  system  that  are  to  be  considered  as  system  jobs.  Figure  4-2 
shows  these  SNUMBs.  An  option  exists  to  add  up  to  12  additional 
SNUMBs  to  this  list.  The  user  can  replace  the  $  FILE  MF,NULL  card  in 
the  RMDRl  JCL  with  a  $DATA  MF  card  and  then  add  a  data  card.  The  data 
card  contains  six  character  SNUMBs  (left  justified)  of  the  jobs  to  be 
added  to  the  system  job  list.  Six  blanks  will  terminate  the  scan  of 
the  data  card. 

4.1.2  RMDRl  Output.  Three  outputs  are  available  from  RMDRl:  (1) 
formatted  dump  of  RMON  data  sorted  by  day  (File  DF),  (2)  System  SNUMB 
List  (File  MF),  (3)  sorted  Resource  Monitor  data  by  day  and  time  of 
day  (File  AF).  When  the  end  of  file  is  encountered  on  the  SCF  tape, 
RMDRl  will  ask  the  operator: 

ARE  THERE  ANYMORE  TAPES  FOR  XXXXX  (Y=YES,  E)OM=ND). 

If  the  operator  responds  Y  or  YES,  RMDRl  will  then  tell  the  operator: 

PLEASE  MOUNT  THE  NEXT  TAPE  FOR  XXXXX  ON  YYYYYY 

wherein  XXXXX  is  the  RMDRl  SNUMB  and  YYYYYY  is  the  data  tape  drive 
ID.  This  option  allows  the  user  to  process  multiple  tapes  in  one 
run.  This  situation  can  occur  if  there  were  several  SCFCLO  commands 
done  during  a  day,  or  if  a  week's  worth  of  daily  tapes  are  to  be  read. 

4.1. 2.1  RMDRl  -  Formatted  Dump  (File  DF).  A  format  dump  of  all  the 
resource  monitor  (RMON)  data  (figure  4—3)  is  output  to  file  code  DF 
sorted  by  day.  File  code  DF  is  normally  set  to  null  file  since  the 
report  contains  a  large  amount  of  data. 

4.1. 2. 2  RMDRl  -  System  SNUMB  List  (File  RP) .  A  list  on  file  RP  of 
all  the  default  System  SNUMBs,  and  also  any  additional  user  generated 
SNUMBs,  is  produced  (Figure  4-4). 
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Figure  4-1.  RNCR  Overview 
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$PALC 

$SYOT 

$RTIN 

TSS 

$TD/S 
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$INCV 

$PACT 

$TRAX 
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$saT 

SSLTA 


Figure  4-2.  RMDR  System 
SNUMB  List 


4. 1.2. 3  RMDR1  -  Sorted  Resource  Monitor  Data  (File  A F).  The  analyzed 
Resource  Monitor  data  is  sorted  by  day  and  time  of  day  and  written  to 
file  code  AF  for  use  by  the  RMDR2  program.  This  file  may  be  a  tape  or 
a  sequential  disk  file  depending  upon  user  space  availability. 

4.1.3  RMDR1  -  Deck  Setup.  The  following  control  cards  are  required 
to  execute  RMDR1 : 


$ 

IDENT 

ACCOUNTING  INFORMATION 

$ 

USERID 

USERIDS  PASSVK3RD/SCC 

$ 

LDWLOAD 

LSW 

$ 

SELECT 

B29 IDPXO/RMON/OBJECT/RMDR1 

$ 

EXECUTE 

DUMP 

$ 

LIMITS 

10, 30K 

$ 

FILE 

SI, SIR, 100R 

$ 

FILE 

MF,NULL 

System  SNUMB  additions 

$ 

FILE 

DF,NULL 

Formatted  Dump  File 

$ 

SYSOUT 

RP 

System  SNUMB  File 

$ 

TAPE 

RM,XlD, , XXXXX 

Accounting  data 

$ 

TAPE 

AF, X2D, XXXXX 

Sorted  RMON  data 

$ 

ENDJOB 

4.2  RMDR2 


RMDR2  reads  the  RMDRl  sorted  RMON  data  from  file  code  AF,  reformats 
that  data,  processes  it,  and  passes  it  to  the  RMDR3  program. 

4.2.1  RMDR2  Inputs.  The  RMDR2  requires  two  inputs  and  has  a  third 
optional  input.  The  required  inputs  consist  of  the  formatted  data 
from  RMDRl,  file  code  AF,  and  a  configuration  card.  The  optional 
input  is  a  date  card. 

4. 2.1.1  RMDR2  -  Configuration  Data  Card  (File  CD).  The  user  defines 
to  RMDR  the  local  site  computer  hardware  configuration  in  terms  of  its 
upper  limit  capabilities.  The  user  must  consult  the  site  computer 
system  boot  deck  to  learn  the  specific  definition  and  structure  of  the 
system.  These  values  will  be  entered  into  the  CDNFIG  data  card 
described  below. 

The  RMDR2  and  RMDR 3  programs  are  then  informed  of  the  system  capacity 
and  the  nature  of  the  collected  data  on  the  SCF  input  tape.  The 
configuration  data  is  contained  in  local  configuration  management 
documents  and  frcm  SFILSYS  SPUTIL  options. 

The  user  should  conplete  this  parameter  card  before  preparing  the  rest 
of  the  RMDR2  JCL  and  any  of  the  RMDR3  JCL. 

An  entry  must  be  made  for  each  parameter,  even  if  zero.  All  entries 
are  of  equal  importance  and  accurate  limits  should  be  used. 

The  (DNFIG  data  card  is  formatted  as  follows: 


4-4 


Figure  A-'J.  RMDR1  Formatted  Dtimi> 


OATE  11-13-79 


Figure  4-4.  RMDR1  Default/User  SNUMB  List 


CONFIG  SYSNAM  MM  P  T  D  AA  BE  CCC  SSS  FF  LLLLLL  NNNNNN  RRRRRR 


The  definition 

of  each 

item  follows: 

Card 

Input 

Column 

Value 

Explanation 

1-6 

CONFIG 

Required  literal 

7 

blank 

3-13 

SYSNAM 

Six  character  system  ID  for  the  system  to  be 
analyzed.  This  may  be  "ANYSYS"  if  only  one 
system  ID  is  on  tape  or  to  analyze  only  the 
first  system  ID  found. 

la 

blank 

15-16 

MM 

Number  of  64K  blocks  of  memory  configured 

17 

blank 

18 

P 

Number  of  processors  configured 

19 

blank 

20 

T 

Number  of  physical  tape  channels  configured 

21 

blank 

22 

D 

Number  of  physical  disk  channels  configured 

23 

blank 

24-25 

AA 

Number  of  tape  drives  configured 

26 

blank 

27-28 

BB 

Number  of  printers  configured 

29 

blank 

30-32 

CCC 

Maximum  number  of  TSS  users  allowed  (050,  100, 
200  valid,  100  recommended) 

33 

blank 

34-36 

SSS 

Maximum  number  of  jobs  allowed  in  the  system 
scheduler  (050,  100,  or  200  valid,  100 
recommended) 

37 

blank 

38-39 

FF 

Maximum  number  of  jobs  allowed  to  be  waiting, 
swapped,  or  executing  (24,  48,  or  96  valid,  96 
recommended) 

40 

blank 

41-46 

LLLLLL 

Number  of  links  of  permanent  file  space 
configured 

47 

blank 

48-53 

NNNNNN 

Number  of  links  of  spare  file  space  configured 

54 

blank 

55-60 

RRRRRR 

Number  of  links  of  removable  file  space 

configured 

61-80  blank 


NOTE:  LLLLLL,  NNNNNN,  and  RRRRRR  are  used  to  determine  the  scaling  factor  for 
the  disk  links  usage  report.  These  figures  can  be  obtained  from  a  SFILSYS 
SPUTIL  option  (see  FMS  Manual  DD45  page  10-14.) 

All  values  are  right  justified,  zero  filled,  and  separated  by  one  blank. 
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4. 2. 1.2  RHDR2  -  Date  Data  Card  (File  DT).  This  data  card  is 
optional.  If  this  option  is  not  required,  a  $  FILE  DT,NULL  should  be 
placed  in  the  JCL.  This  card  allows  a  site  to  specify  a  particular 
cate  to  be  analyzed.  If  specified,  only  data  for  that  date  will  be 
processed.  If  not  specified,  the  first  date  found  will  be  processed. 
This  option  can  also  be  used  to  specify  an  analysis  of  all  the  days  on 
a  tape  as  a  group  (i.e.,  a  weekly  analysis  of  data).  If  a  date  is 
specified  that  is  not  on  the  data  tape,  an  error  condition  will  occur 
and  processing  will  halt. 

4. 2. 1. 2.1  Daily  Processing.  If  this  option  is  selected,  the  data 
card  must  be  as  follows: 

DAYDATYYMMDDWWW 

Where 

DAYDAT  Required  literal 

YY  Year  number 

tlM  Month  number 

DD  Day  number  of  month 

NAM  Day  name  in  3  characters 

(MON,  TUE,  WED,  THU,  FRI,  SAT,  SUN,  or  blank, 

EXAMPLE:  DAYDAT790727FRI  would  process  data  for  Friday,  the  27th  of 
July  1979. 

NOTE:  Conmercial  4Jx  systems  should  input  the  day-date  as  MMDDYY. 

4. 2. 1.2. 2  weekly  Processing.  If  this  option  is  selected,  the  data 
card  must  be  as  follows: 

WEEKLY 

Where: 

WEEKLY  =  Required  literal 

This  option  will  combine  a  weeks  worth  of  data  into  one  set  of  output 
charts.  It  will  not  put  out  a  separate  chart  for  each  day  of  the  week. 

4.2.2  RMDR2  Outputs.  Three  outputs  are  produced  by  RMDR2:  (1) 
reformatted  RMON  data  to  be  passed  to  RMDR3 ,  (2)  error  reports,  (3) 
echo  print  of  input  data. 


4. 2. 2.1  RMDR2  -  Reformatted  RMC  Data  (File  OT) .  This  file  contains 
all  the  data  that  has  been  processed  by  RMDR2  and  is  ready  for  the 
graphic  routine,  RMDR3. 

4. 2. 2. 2  RMDR2  -  Error  Reports  (File  RP).  This  file  contains  a 
listing  of  any  values  that  exceed  the  user  specifications  on  the 
CONFIG  card.  RMDR2  will  analyze  all  the  RMON  data,  collect  it  into  15 
minute  timeframes,  and  compare  it  to  the  CONFIG  card  values.  Any  data 
that  is  greater  than  the  figures  read  in  on  the  OONFIG  card  will  be 
highlighted.  Values  for  memory,  processor,  tape  channel  usage,  or 
disk  channel  usage,  which  exceed  the  CONFIG  card  value  by  less  than  10 
percent,  are  truncated  to  the  CONFIG  card  value  and  noted  on  this 
report.  If  they  exceed  the  value  by  more  than  10  percent,  they  are 
dropped.  Any  other  value  which  exceeds  the  value  on  the  CONFIG  card 
is  also  dropped  and  is  noted  on  this  report.  (See  figure  4-5.) 

4. 2. 2. 3  RMDR2  -  Input  Data  Echo  Print  (File  P*).  This  report  just 
echo  prints  any  value  input.  (See  figure  4-6.) 

4.2.3  RMDR2  Deck  Setup.  The  following  control  cards  are  required  to 
execute  RMDR2: 

$  SNUMB 

$  IDENT 

$  USERID 

$  OPTION 

$  SET 

$  SELECT 

$  EXECUTE 

$  LIMITS 

$  PRMFL 

$  FILE 

$  SYSOUT 

$  DATA 

OONFIG  ANYSYS  08 
$  DATA 

DAYDAT790416MON 
$  FILE 

4.3  RMDR3 

RMDR3  reads  the  formatted  RMDR2  data  and  prints  graphs  for  16  values. 

4.3.1  RMDR3  Inputs.  The  RMDR3  requires  two  inputs:  (1)  formatted 
data  from  RMDR2  ($FILE:OT,FIS,20L) ,  (2)  a  data  card  specifying  which 
graphs  to  process  (File-$DATA:CD) . 


COBOL 

9 

B  29 IDPXO/RMON/OBJECT/RMDR2 

DUMP 

25 

IN,R,S, CAT/FILE/STRING  FOR  SORTED  RMON  DATA 
OT,FIS, 20L 
RP 
CD 

2  3  8  18  07  100  100  48  072100  019000  015100 
DT 

TC,NULL 
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Figure  4-6.  RMDR2  Input  Data  Echo  Print 


4. 3. 1.1  RM0R3  -  Formatted  Data  (File  IN).  This  sequential  file 
contains  the  RMDR2  formatted  RMON  data. 


4. 3. 1.2  RMOR3  -  Requested  Graphs  (File  CD).  This  input  parameter 
card  allows  the  user  to  specify  which  graph  wili  be  produced.  The 
data  card  options  are  shown: 

REPORTXXXXXXXXXXXXXXXX 

Enter  a  Nonblank  character  for  each  report 
to  be  turned  on.  The  reports,  in 
order  of  production,  are: 

Card 

Column  Input  Value 


1-6 

REPORT  -  (Required  literal) 

7 

= 

Processor  Utilization 

8 

= 

Memory  Utilization 

9 

= 

Jobs  in  Execution 

10 

= 

Jobs  Swapped 

11 

= 

Jobs  Waiting  Memory 

12 

= 

Jobs  Waiting  PflLC 

13 

= 

Active  Jobs  in  Scheduler 

14 

= 

"HOLD"  Jobs  in  Scheduler 

15 

= 

TSS  Users 

16 

= 

TSS  Processor  Usage 

17 

= 

TSS  Memory  Utilization 

18 

= 

Tape  Channel  Utilization 

19 

= 

Tape  Drive  Allocation 
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20 


Printer  Utilization 


21  =  Disc  Channel  Utilization 

22  =  Disc  -  LKS  in  Thousands 

4.3.2  RNOR3  Outputs.  Two  outputs  are  produced  by  RMDR3:  (1)  input 
report  (File  PX),  (2)  graphs  (File  RP). 

4. 3. 2.1  RNCR3  -  Input  Report  (File  P*).  This  report  echo  prints  the 
REPORT  Card  used  as  input  by  the  user.  It  also  lists  any  graph  turned 
off  by  the  user.  (See  figure  4-7.) 

4. 3. 2. 2  RMDR3  -  Graphs  (File  RP).  The  RNOR3  produces  up  to  16 
graphs.  Each  graph  contains  the  following:  System  name,  date  (range 
of  days  if  Weekly  option  used  for  RMDR2,  day  of  week  if  included  in 
input  to  RM)R2) ,  graph  title,  summary  of  graph  maximum,  and  average 
values  over  eight  hour  segments  of  time  (0-8,  8-16,  16-24)  and  over 
full  day,  Y-axis  increment  if  not  equal  to  one,  start  and  stop  time  of 
data,  time  increment  of  each  bar  (normally  14.98  minutes).  A  bar  is 
normally  plotted  for  each  15  minutes  of  data.  The  time  of  day  is 
printed  at  the  bottom  of  each  graph.  The  Y-axis  range  is  produced  on 
the  right  and  left  sides  of  each  graph.  Unless  stated  in  the  graph 
heading,  each  graph  point  is  one  unit  of  measurement.  Figures  4-8 
through  4-23  show  all  the  reports. 

4. 3. 2 .2.1  Processor  Utilization.  This  graph  shows  how  busy  all 
processors  were  during  the  collection  period.  The  maximum  value  on 
the  graph  is  the  number  of  processors  times  100%.  Three  different 
values  are  plotted:  S  -  system  jobs  (see  subsection  4.1.1  for 
explanation  of  system  jobs),  *  -  slave  jobs,  T  -  TSS. 

4. 3. 2. 2. 2  Memory  Utilization.  This  graph  shows  how  memory  was  used 
during  the  collection  period.  The  three  values  plotted  in  this  graph 
are  the  same  as  in  the  Processor  Utilization  graph. 

4. 3. 2. 2 .3  Jobs  in  Execution.  This  graph  shows  the  number  of  jobs  (S 
-  system,  *  -  slave)  in  execution  during  the  monitored  period. 

4. 3. 2 .2. 4  Jobs  Swapped.  This  graph  shows  the  number  of  jobs  (S  - 
system,  *  -  slave)  swapped  during  the  monitored  period. 

4.3 .2 .2.5  Jobs  Waiting  Memory.  This  graph  shows  all  jobs  (S  - 
system,  *  -  slave)  that  waited  memory. 
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Figure  4-7.  RMDR3  Input  Report 
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Figure  4»- 10.  Job*  in  Execution 
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Figure  4-14.  Active  Jobs*  In  Scheduler 
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4. 3. 2. 2. 6  Jobs  Waiting  PALC.  This  graph  shows  all  jobs  (S  -  system, 

*  -  slave)  that  waited  peripheral  allocation. 

4. 3. 2. 2. 7  Active  Jobs  in  Scheduler.  This  graph  shows  all  active  jobs 
waiting  in  the  scheduler.  The  two  values  graphed  are  jobs  in  the 
Express  queue  (E)  and  all  other  queues  (*). 

4. 3. 2 .2. 8  Hold  Jobs  in  Scheduler.  This  graph  shows  all  the  jobs  that 
were  put  into  the  HOLD  class  of  the  system  scheduler.  The  two  values 
graphed  are  jobs  in  the  HOLD  class  (H)  and  jobs  in  the  user  normal 
class  that  have  been  shut  (S).  A  class  that  has  been  shut  off  by  use 
of  the  JEND  verb  is  not  considered  "SHUT."  Only  classes  explicitly 
shut  or  open  (number  of  jobs  allowed  in  the  system)  are  considered. 

4. 3. 2 .2. 9  TSS  Users.  This  graph  shows  the  number  of  users  logged 
onto  TSS  during  the  monitoring  period. 

4.3.2.2.10  TSS  Processor  Usage.  This  graph  shows  the  percentage  of 
the  processor  power  used  by  TSS.  This  is  an  extension  of  the 
Processor  Utilization  graph. 

4.3.2.2.11  TSS  Memory  Utilization.  This  graph  shows  the  percentage 
of  memory  used  by  TSS.  This  is  an  extension  of  the  Memory  Utilization 
graph. 


4.3.2.2.12  Tape  Channel  Utilization.  This  graph  shows  the  tape 
channel  utilization  of  the  total  tape  channel  configuration. 

4.3.2.2.13  Tape  Drive  Allocation.  This  graph  shows  the  number  of 
tape  drives  in  use.  The  three  values  plotted  show  those  drives  that 
are  dedicated  (0),  unavailable  (U),  which  can  mean  they  are  released 
or  being  used  for  TAD,  or  in  use  (*). 

4.3.2.2.14  Printer  Utilization.  This  graph  shows  the  number  of 
printers  in  use.  The  three  values  plotted  show  those  printers  that 
are  dedicated  (D),  unavailable  (U),  or  in  use  (*). 

4.3.2.2.15  Disc  Channel  Utilization.  This  graph  shows  the  disc 
channel  utilization  of  the  total  disc  channels  configured. 

4.3.2.2.16  Oise  LKS  in  Thousands.  This  graph  shows  the  variability 
of  the  links  configured  on  the  system.  The  three  values  plotted  are 
removable  links  (R),  permanent  links  (*),  space  and  scratch  links 
(S).  The  V  increment  gives  the  value  of  each  character  graphed. 
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4.3.3  RfCR3  -  Deck  Setup.  Tt>e  following  control  cards  are  required 
to  execute  RMDR3: 

$  OPTION  COBOL 

$  SELECT  B29IOPXO/RMON/QBJECT/RNOR3 

$  EXECUTE 

$  LIMITS  25,26K,20K 

$  FILE  IP,F2R,200L 

S  FILE  IN,F1R,20L  Input  from  RMDR2 

$  FILE  S1,S1R,20R 

$  SYSOUT  RP 

$  DATA  CD 

REPORT XXXXXXXXXXXXXXXX 
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SECTION  5.  THE  GENERAL  MONITOR  COLLECTOR  -  DATA  COLLECTION  PROGRAM 
5.1  Introduction 

The  General  Monitor  Collector  (GMC)  data  collection  progran  is  a 
privileged  slave  progran  which  processes  GCOS  systen  trace  data, 
organizes  the  data  in  GMC  records,  and  writes  the  collected  GMC  data 
records  on  its  output  nagnetic  tape.  The  general  concept  of  operation 
for  the  GMC  facility  is  shown  in  figure  5-1. 

As  a  privileged  slave  progran,  the  nonitor  data  collector  requi res  the 
permission  of  the  systen  operator  to  run  and  nust  execute  in  master 
node.  The  master  node  capability  allows  the  GMC  to  access  all  of  the 
systen  main  memory.  The  areas  of  interest  are  the  systen 
Communication  Region  ( CR )  and  the  individual  job  Slave  Service  Areas 
(SSAs) . 

The  GMC  is  actually  a  series  of  independent  data  collection  monitors 
which  are  controlled  via  the  central  Executive  Routine  (ER)  (described 
in  subsection  5.3.1),  and  which  use  a  common  buffering  routine  for 
writing  collected  data  to  a  common  tape.  The  current  GMC  is  comprised 
of  nine  different  monitors,  which  can  be  executed  independently,  or  in 
any  combination.  The  monitors  are  described  in  this  section.  Each  of 
the  monitors  has  a  dedicated  data  reduction  program  that  produces 
formatted  reports.  These  data  reduction  programs  are  described  in 
sections  6  through  12. 

The  GMC  can  obtain  control  from  the  systen  in  one  of  three  ways. 

First,  the  standard  manner  is  for  the  GMC  to  obtain  control  via  the 
normal  system  trace.  Second  and  third,  GMC  nay  also  gain  control  in 
two  nonstandard  manners.  These  are  via  internally  created  system 
sub-traces  (referred  to  as  IT  traces)  and  direct  transfer  patches 
(referred  to  as  DT  traces). 

In  the  first  way,  the  standard  mechanism  used  by  the  monitor  for 
obtaining  control  from  the  operating  systen  is  the  normal  GCOS  system 
trace.  The  system  trace  capability  records  a  history  of  the 
occurrence  of  as  many  as  72  system  events,  64  of  which  are  presently 
defined.  This  recording  takes  place  in  a  circular  table  in  the 
Communication  Region  of  memory  and  is  accomplished  by  execution  of  a 
unique  code  set  resident  in  the  systen  Dispatcher  Module  (.HOISP). 
Execution  of  this  code  is  cocnon  to  all  systen  trace  events  and 
provides  the  point  at  which  the  GMC  obtains  control.  The 
initialization  portion  of  the  GMC  locates  the  system  trace  code  set 
and  implants  a  transfer  instruction  to  the  GMC  executive.  Thus, 
whenever  a  system  trace  event  occurs  anywhere  within  the  systen,  the 
GMC  executive  will  obtain  control. 
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Figure  5-1.  GMC  Concept 
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After  obtaining  control,  the  system  trace  recording  is  completed  using 
normal  system  procedures  and  then  the  trace  is  investigated.  If  an 
executing  GMF  monitor  requires  this  trace  type,  control  is  given  to 
that  monitor.  The  nonitor  then  collects  data  of  interest  to  itself 
and  requests  the  GMC  executive  to  buffer  the  data.  When  the  monitor 
completes  its  task,  it  returns  control  to  the  GMC  executive.  The  GMC 
executive  then  transfers  control  back  to  the  system  trace  processing 
routine  within  the  GCOS  dispatcher.  The  activities  mentioned  above 
take  place  in  master  mode  under  the  guise  of  an  extension  of  normal 
systen  trace  procedures. 

The  second  method  used  by  GMC  to  gain  control  is  for  GMC  to  create  its 
own  system  traces.  The  GMC  will  search  a  given  GCOS  nodule  for  a 
known  line  of  code.  It  will  replace  this  line  of  code  with  a  transfer 
to  a  patch  area.  In  the  patch  area,  the  monitor  will  insert  code  to 
create  a  new  GMC  system  trace.  At  this  point,  the  execution  of  this 
code  will  be  processed  just  as  all  other  system  traces  are  processed. 
This  procedure  is  used  only  when  the  Comunication  Analysis  Monitor  is 
selected  for  execution.  (See  subsection  5.2.6  for  a  complete 
description  of  this  procedure.) 

The  third  method  used  by  GMC  to  gain  control  is  via  a  direct  transfer 
from  a  GCOS  module.  In  this  case,  GMC  will  search  a  given  GCOS  module 
for  a  known  line  of  code.  It  will  replace  this  line  of  code  with  a 
direct  transfer  into  the  GMC.  This  can  be  accomplished  since  GMC  is 
locked  in  core  during  its  entire  execution.  The  benefit  of  this 
procedure  is  that  the  overhead  of  the  systen  trace  is  eliminated.  This 
procedure  is  used  only  when  the  Mass  Store  Monitor  or  the  CPU  Monitor 
is  selected  for  execution.  (See  subsections  5.2.2  and  5.2.3  for  a 
complete  description  of  this  procedure.) 

As  the  GMC  ER  buffers  the  collected  monitor  data,  it  will  determine 
when  one  of  the  internal  buffers  are  filled  and  must  be  written  to 
tape.  At  this  point,  it  will  establish  a  normal  slave  dispatch  to  its 
tape  writing  facility.  The  tape  writing  facility  will  then  write  the 
internal  buffer  to  tape  and  signal  the  executive  that  this  buffer  may 
be  reused. 

5. 2  GMC  Monitor  Subroutines 

In  this  subsection,  each  of  the  nine  monitor  subsystems  will  be 
addressed.  Each  subsystem  requires  that  specific  trace  types  be 
enabled  in  the  H6000  system  boot  deck  on  the 

$  TRACE  card.  A  detailed  discussion  of  the  computer  system  boot  deck 
used  for  startup  and  S  TRACE  operations  is  contained  in  the  GCOS 
System  Startup  Manual  and  in  the  System  Tables  Manual.  GMC  cannot  be 
used  to  turn  on  or  off  a  TRACE  option.  The  GMC  user  must  request  the 
computer  systen  manager  to  change  the  system  boot  deck  $  TRACE  card  to 
meet  the  minimum  GMC  requi rements.  If  all  the  required  trace  types 
are  not  on,  GMC  will  abort  with  a  TO  through  T8  abort.  The  digit 
imediately  following  the  letter  T  indicates  the  monitor  number  for 
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which  the  proper  traces  are  not  active.  See  table  5-1  for  a  quick 
reference  of  required  trace  types  for  each  monitor  and  refer  to  table 
5-2  for  all  GMC  abort  codes. 

5.2.1  Memory  Utilization  Monitor.  The  Memory  Utilization  Monitor 
(MUM)  is  used  to  measure  memory  utilization.  For  a  detailed 
description  of  reports  containing  data  collected  by  this  monitor,  see 
section  6. 

When  MUM  is  active  it  is  essential  that  GCOS  system  trace  types 
(octal)  10,  11 ,  46  and  51  are  enabled  in  the  computer  system  boot  deck 
$  TRACE  card.  MUM  collects  data  upon  the  occurrence  of  those  traces 
and  builds  its  records  which  are  then  passed  to  the  Executive  Routine 
(ER)  for  buffering.  A  separate  discussion  of  the  format  of  the  MUM 
collected  data  records  is  contained  in  subsection  5.4.2.  MUM  requires 
that  at  least  the  following  segment  numbers  from  table  5-3  be  used  to 
generate  the  GMC  R*  f i 1 e :  1  ,  2,  11  ,  19,  23,  26  and  27.  The  complete 
process  for  generating  an  R*  file  is  described  in  subsection  5.6.  It 
should  be  noted  that  this  version  of  MUM  will  not  collect  any  idle 
trace  information  and  therefore  not  all  MUM  reports  will  be  produced 
during  data  reduction.  See  section  6  for  description  of  reports  that 
will  not  be  produced. 

If  the  user  wants  all  the  MUM  reports  produced,  then  the  Idle  Monitor 
must  be  made  active,  along  with  the  Memory  Monitor.  To  do  this,  GCOS 
trace  types  (octal)  0,  1,  2,  3,  10,  11,  13,  16,  21,  22,  37,  46,  51  and 
65  must  be  enabled.  In  generating  the  R*  file  the  following  segment 
nunbers  should  be  used:  1,  2,  10,  11,  19,  23,  24,  25,  26  and  27.  It 
should  be  noted  that  when  the  Idle  Monitor  is  active  the  amount  of 
data  collected  will  be  about  double  that  collected  when  the  Idle 
Monitor  is  off.  The  user  should  carefully  evaluate  the  need  for  those 
reports  produced  by  the  Idle  Monitor. 

The  MUM  is  designed  so  that  it  can  accurately  report  all  changes  to 
the  memory  subsystem.  It  does  this  by  processing  all  trace  type  10 's 
(.CALL)  and  all  trace  type  ll's  (.GO  TO).  Upon  receiving  these  traces 
a  further  check  is  made  to  see  whether  a  memory  allocation  process  Is 
being  requested  i.e.  the  use  of  SSA  modules:  .MPOP3,.W>OQ4,  or 
MP0R5.  The  MUM  will  collect  data  only  if  one  of  these  modules  has 
been  requested. 

The  first  item  of  information  reported  by  the  MUM  is  the  current 
status  of  all  jobs  waiting  in  the  Peripheral  Allocator's  Queue.  This 
information  is  reported  so  as-  to  be  better  able  to  represent  the  true 
core  demand  being  made  by  the  current  workload.  When  a  GCOS  system 
has  a  large  number  of  jobs  waiting  core,  a  Core  Damper  Switch  is  set. 
This  switch  is  used  to  prevent  jobs  from  being  sent  from  the 
Peripheral  Allocator  to  the  Core  Allocator.  Therefore,  the  Peripheral 
Allocator's  queue  may  contain  many  jobs  that  would  normally  be  in  the 
Core  Allocator's  queue,  were  it  not  for  the  Core  Damper  Switch.  This 


Table  5-1.  Required  Trace  Type  for  Each  Monitor 


Monitor  #  Monitor 
{octal ) 

0  Memory  Utilization  Monitor 

(MUM) 

1  Mass  Storage  Monitor 

(MSM) 


Required  Trace  Type 


10,  11,  46,  51,  (Idle 
Monitor 

traces  optional) 

7,  15,  73*.  76* 


2  CPU  Monitor  (CPUM) 

3  Tape  Monitor  (TM) 

4  Channel  Monitor  (CM) 

5  Communications  Analysi s 
Monitor  (CAM) 


10,  11,  21,  70* 

50,  51,  52 

4,  7,  15,  22  (Idle 
Monitor 

traces  optional) 
14* 


6  GP.TS  Monitor  (GRTM) 


62* 


7  Idle  Monitor  (IDLEH) 


8  Transaction  Proc- 

cessing  System 
Monitor  (TPSM) 


0,  1,  2,  3,  13,  16,  21, 
22,  37,  65 

0,  1,  2,  4,  5,  6,  13, 
42,  51,  65,  74* 


*These  are  not  standard  traces.  They  are  specially  created  by  the  GMC 
or  by  an  editing  of  the  GCOS  TPE  Subsystem  in  the  case  of  trace  type 
74.  Trace  types  70,  73  and  76  are  direct  transfers  into  the  GMC  and 
as  such  are  not  required  to  be  active  via  the  $  TRACE  card  in  the 
system  boot  deck.  Trace  types  14,  62  and  74  do  use  the  System  Trace 
Function  and  require  the  Trace  Number  to  be  active  on  the  $  TRACE  card. 


Table  5-2.  Abort  Codes  (Part  1  of  3) 

BC  -  Illegal  request  on  limited  connect  option. 

BK  -  Backspace  of  the  full  data  tape  was  bad.  Multireel  will  not  be 
collected.  Check  for  tape  drive  problems. 

BS  -  Bad  tape  status.  Check  condition  of  tape  and  rerun  job. 

Cl  -  CPU  Monitor  turned  off  but  SMUMB  input  requested  on  the  data 

card. 

C2  -  Illegal  SNUMB  (more  then  five  characters)  on  data  card. 

C3  -  More  then  three  SNUMBS  for  CPU  Monitor  on  data  card. 

CD  -  Illegal  character  in  CAM  special  option. 

CE  -  Console  message  garbled.  Check  console  sheet  and  check  with 

operator. 

CM  -  Cannot  move  out  of  the  growth  range  of  TSS. 

CO  -  CAM  turned  off  but  special  option  requested. 

DK  -  No  multireel  disk  file  was  present.  Use  a  $  FILE  card  in  the 

JCL  or  use  the  M9  option  to  turn  off  multireel  capability. 

DR  -  Disk  read-in.  End-of-reel  processing  was  bad. 

DS  -  Bad  status  of  the  disk  write. 

ER  -  Wrapup  record  could  not  be  written. 

ET  -  More  than  two  terminals  requested  for  CAM  special  option. 

FN  -  The  IOS  accounting  modification  could  not  be  found.  Call  CCTC 

GC  -  No  GRTS  control  card. 

GD  -  No  FEP  I/O  can  be  performed. 

GM  -  Needed  memory  for  GRTS  Monitor  denied.  Increase  $LIMIT  card. 

GO  -  GRTS  Monitor  illegal  data  card. 

GS  -  Extra  SSA  is  not  available  for  GRTS  Monitor.  Check  $  LIMIT  card 
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Table  5-2.  (Par t  2  of  3) 

M0-M8  -  Monitor  was  not  turned  off  and  not  present  on  the  R*  file. 

Any  monitor  not  contained  on  the  R*  file  must  be  turned  off  via 
the  data  card  option.  The  number  following  the  M  is  the 
monitor  that  was  not  turned  off. 

MM  -  The  dispatcher  hook  has  already  been  inserted.  Another  version 
of  GMC  must  already  be  in  execution. 

N1  -  The  CPU  Monitor  hook  code  could  not  be  found.  See  subsection 
5.2.3. 

N2  -  Sufficient  patch  space  is  not  available  in  .MDISP  to  run  the 
CPU  Monitor.  See  subsection  5.2.3. 

N3  -  DUWW/MDNET  patch  location  could  not  be  found.  See  subsection 
5.2.6. 

N4  -  Sufficient  patch  space  is  not  available  in  DMWW/MDNET  to  run 
the  Conmuni cation  Analysis  Monitor.  See  subsection  5.2.6. 

N5  -  MSM  patch  for  SSA  cache  analysis  not  found  (AOS  .CRTDL).  See 
subsection  5.2.2. 

N6  -  MSM  patch  for  SSA  cache  analysis  not  found  (AOS  .CRTBH).  See 
subsection  5.2.2 

N7  -  MSM  patch  space  in  .MDISP  not  sufficient  for  monitoring  SSA 
cache.  See  subsection  5.2.2. 

N8  -  CPU  Monitor  hook  code  for  subdispatch  could  not  be  found.  See 
subsection  5.2.3. 

NF  -  The  Dispatcher  hook  code  could  not  be  found.  Call  CCTC/C751 . 

OE  -  An  error  in  an  off  option  was  encountered.  Check  the  data 

cards. 

OK  -  All  went  correctly. 

OL  -  Overlap  of  disk  file.  Increase  size  of  disk  file.  Check  if 
operator  failed  t»  respond  to  tape  mount  message  during 
multiprocessing. 

OV  -  A  tally  overflow  occurred  in  the  MUM.T10  subroutine.  Increase 
the  size  of  the  data  area  within  subroutine  MUM.T10,  variable 
SIZEBUF. 


Table  5-2.  (Part  3  of  3) 


RS  -  Routine  depth  requested  exceeded  table  length. 

RW  -  Error  in  initial  rewind.  Check  tape  and  drive. 

SB  -  End-of-reel  processing  was  bad.  Check  tape  and  drive. 

SD  -  Error  setting  of  density. 

SF  -  Limited  reel  option  termed  successfully. 

SQ  -  Sequence  error  in  the  physical  records. 

51  -  Subroutine  MUM.T10  missing 

52  -  Subroutine  MUM.T46  missing 

53  -  Subroutine  CM.T07A  missi ng 

54  -  Subroutine  CPU.T70  missing 

55  -  Subroutine  CM. T04A  missing 

56  -  Subroutine  CM.T22A  missing 

57  -  Subroutine  7M.T50  missing 

58  -  Subroutine  CAM.T14  missing 

59  -  Subroutine  GRT.T62  missing 

SA  -  Subroutine  IDL.TRCS  missing 
SC  -  Subroutine  IDL.T21  missing 

SD  -  Subroutine  TPE200  missing 

TE  -  The  start/stop  times  appear  improper.  Check  data  card. 

TL  -  Trailer  record  write  was  bad.  Check  tape  and  drive. 

TS  -  An  OK  abort  directed  by  a  time  to  stop  command. 

TW  -  The  tally  word  has  been  garbled. 

T0-T8  -  Required  system  trace  Is  not  on.  The  number  following  the  T 
indicates  the  monitor  having  the  problem. 
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Table  5-3.  GMC  Catalog  and  File  Index  {Part  1  of  3) 

SEGMENT 


# 

FILE  REQUIRE!) 

FUNCTION 

1 

GMF.TOP  Y 

Read  data  card,  initialization,  find 
hook  in  dispatcher,  and  create  initial 
record 

2 

MUM. I  NIT 

Initialize  flemory  Monitor 

3 

MSM.INIT 

Initialize  Mass  Store  Monitor 

4 

CPU.INIT 

Initialize  CPU  Monitor 

5 

CAM.INIT 

Initialize  Communications  Analysis  Monitor 

6 

CM. I HIT 

Initialize  Channel  Monitor 

7 

TM.INIT 

Initialize  Tape  Monitor 

8 

GRT.IMIT 

Initialize  DN-355  Monitor 

9 

TP.INIT 

Initialize  TPE  Monitor 

10 

IDL.INIT 

Initialize  Idle  Monitor 

11 

GMF.MIO  Y 

Ensure  at  least  one  active  monitor 

12 

CAM. PAT 

Preparation  for  patching  DNWW/MDNET  for 
Comuni cations  Analysis  Monitor 

13 

CPU. PAT 

Preparation  for  patching  dispatcher  for 

CPU  Monitor 

14 

MSM.PAT 

Preparation  for  patching  dispatcher  for 

MSM  Cache  Analysis 

15 

PATLOOK 

Searches  for  patch  space  for  CPUM,  CAM, 

MSM 

16 

CPUDOIT 

Patch  the  dispatcher  for  CPU  Monitor 

17 

CAMOOIT 

Patch  DNWW  for  Conmunl cation  Analysis 
Monitor 

18 

MSMDOIT 

Patch  dispatcher  for  MSM  Cache  Analysis 
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Table  5-3.  (Part  2  of  3) 


SEGMENT 


# 

FILE 

REQUIRED 

19 

GMF.MON 

Y 

20 

CPU. REMO 

21 

CAM. REMO 

22 

MSM. REMO 

23 

GMF.BTW 

Y 

24 

IDL.TRCS 

25 

I0L.T21 

26 

MUM.T10 

27 

MUM.T46 

28 

CPU.T7Q 

29 

TM.T50 

30 

CAM.T14 

31 

CM.T04A 

32 

CM.T22A 

33 

CM.T07A 

34 

GRT.T62 

35 

GRT.COL 

FUNCTION 

Insert  the  trace  hook  for  GMC  traces 

Remove  CPU  Patches  to  dispatcher 

Remove  CAM  patches  to  DNWW/MDNET 

Remove  MSM  patches  to  dispatcher 

Remove  the  trace  hook,  do  all  10 
control 

Processes  traces, 
0,1,2,3,13,16,22,37,  and  65  for 
Idle  Monitor 

Processes  trace  21  for  Idle  Monitor 

Processes  traces  10,  11,  and  51  for 
Memory  Monitor 

Processes  trace  46  for  Memory 
Monitor 

Processes  traces,  10,11,21,  and  70 
for  CPU  Monitor** 

Processes  traces  50,51,52  for  Tape 
Monitor 

Processes  trace  14  for  CAM* 

Processes  trace  4  for  Channel 
Monitor 

Processes  trace  22  for  Channel 
Monitor 

Processes  traces  7,15,73,76  for 
Channel  Monitor  and  Mass  Store 
Monitor** 

Processes  trace  62  for  GRTS  Monitor* 
Interfaces  with  the  DN-355 
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Table  5-3.  (Part  3  of  3) 


SEGMENT 


FILE 

REQUIRED 

FUNCTION 

36 

TPE200 

Processes  traces 

0,1,2,4,5,6,13,42,51,65  and  74  for 
TPS  Monitor* 

37 

RUN.GMF 

JCL  to  run  a  GMC  R* 

38 

GMF .  OBJ 

File  to  contain  a  GMC  R* 

39 

MAKE. XXX 

A  series  of  files  creating 
different  GMC  R*  Monitors. 

39A 

MAKE.MUC 

Memory  and  CPU  Monitors 

39B 

HAKE. ALL 

Total  GMC 

39C 

MAKE. MUM 

Memory  Monitor 

39D 

MAKE. CPU 

CPU  Monitor 

39E 

MAKE.  TM 

Tape  Monitor 

39F 

MAKE.MSM 

Mass  Store  Monitor 

39G 

MAKE.MCC 

Memory,  CPU,  Communications  and 

Idle  Monitors 

39H 

MAKE. MCI 

Mass  Store,  Channel  and  Idle 
Monitors 

391 

MAKE. CAM 

Communications  Analysis  Monitor 

39J 

MAKE. CM 

Channel  Monitor 

39K 

MAKE.GRT 

DATANET-355  Monitor 

39L 

MAKE.CMI 

Channel  and  Idle  Monitors 

39M 

MAKE.MCM 

Mass  Store  and  Channel  Monitors 

39N 

MAKE.GC 

Communications  and  DATANET  Monitors 

390 

MAKE.TPE 

TPE  Monitor 

♦Trace 

types  14,62  and 

74,  are  not 

standard.  They  are  internally 

generated  (IT)  traces. 

♦♦Trace  types  70,73  and  76  are  not  standard.  They  are  direct  transfer 
(DT)  traces. 
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information  from  the  Peripheral  Allocator  is  reported  only  when  the 
Peripheral  Allocator  is  in  memory  and  a  Memory  Monitor  trace  is  about 
to  be  generated.  For  this  reason,  not  all  Peripheral  Allocator  queue 
changes  will  be  reported.  In  order  to  reduce  the  amount  of 
information  being  collected,  a  job's  status  in  the  Peripheral 
Allocator's  queue  is  reported  only  for  new  jobs,  when  a  job  has 
changed  activity,  or  when  its  status  has  changed. 

After  reporting  any  Peripheral  Allocator  status  information,  the  MUM 
will  next  report  the  status  of  every  job  waiting  for  or  currently 
using  memory.  Information  such  as  the  SNUMB,  IDENT,  USERID,  Activity 
Number,  memory  demands,  current  memory  address,  whether  the  job  is  in 
memory  or  waiting  fur  memory,  and  whether  the  job  is  a  system  program 
or  user  program  is  collected.  This  information  is  reported  for  each 
job  only  if  a  change  has  occurred  from  previous  information  that  was 
reported.  In  addition,  the  current  amount  of  CPU  and  10  time  used  by 
a  job  is  reported  in  every  MUM  trace  that  is  generated. 

The  MUM  will  consider  a  job  to  be  a  system  job  if  it  has  a  program 
number  less  then  octal  10,  or  if  it  has  no  J*  file  and  requires 
privity.  Since  the  user  may  want  to  consider  other  jobs  to  be  system 
jobs,  such  as  HEALS  or  VIDEO,  the  data  reduction  program  allows  the 
user  to  extend  this  definition  of  system  jobs  (see  section  6). 

5.2.2  Mass  Storage  Monitor.  The  Mass  Storage  Monitor  (MSM)  is  used 
to  collect  data  on  usage  of  peripheral  resources.  For  a  detailed 
description  of  reports  containing  data  collected  by  this  monitor,  see 
section  7. 

When  the  user  wants  MSM  to  be  active,  it  is  essential  that  trace  types 
(octal)  7  and  15  are  enabled  in  the  computer  system  boot  deck  on  the 
i  TRACE  card.  MSM  processes  trace  types  7,  15,  73,  and  76  to  build 
its  own  records  which  are  passed  to  ER.  A  separate  discussion  of  the 
format  of  the  MSM  collected  data  records  is  contained  in  subsection 
5.4.3.  As  has  been  stated  earlier,  trace  types  73  and  76  are  direct 
transfer  traces  created  by  the  GMC,  and  as  such  need  not  be  defined  on 
the  $  TRACE  card.  The  MSM  requires  that  at  least  the  following 
segment  numbers  from  table  5-3  be  used  to  generate  the  GMC  R*  file: 

1,  3,  11,  14,  15,  18,  19,  22,  23,  and  33.  The  complete  process  for 
generating  an  R*  file  is  described  in  subsection  5.6.  If  the  system 
being  monitored  by  the  Mass  Store  Monitor  contains  SSA  Cache  Core,  two 
new  direct  transfer  traces,  are  created  by  the  Mass  Store  Monitor  in 
order  to  collect  sufficient  data  to  be  able  to  analyze  the  operation 
of  SSA  Cache  Core.  These  traces  are  created  only  if  SSA  Cache  Core  is 
configured.  The  Mass  Store  Monitor  searches  the  dispatcher  for  a  AOS 
.CRTDL  instruction  and  then  inserts  code  to  make  a  direct  transfer 
into  the  GMF.  In  addition,  an  AOS  .CRTBH  instruction  is  also  searched 
for  so  that  another  direct  transfer  into  the  GMC  can  be  generated. 

The  first  Instruction  locates  the  area  of  the  dispatcher  where  it  has 
been  determined  that  the  required  SSA  module  is  not  in  the  SSA  Cache 
Buffer  ar.d  needs  to  be  loaded  from  disk.  The  second  instruction 
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locates  that  area  of  the  dispatcher  where  it  has  been  determined  that 
the  required  SSA  module  is  in  the  SSA  Cache  Buffer.  The  search  for 
these  instructions  begins  at  octal  location  4600  in  WW6.4  or  7164  in 
WW7.2  and  continues  to  octal  location  5100  in  WW6.4  or  7464  in  WW7.2 
within  the  dispatcher.  If  GMC  cannot  find  these  instructions  between 
these  locations,  it  will  abort  with  an  N5  or  an  N6  abort.  If  this 
problem  occurs,  the  dispatcher  code  should  be  examined  to  see  if  this 
instruction  has  been  moved  or  modified.  If  so,  the  code  in  GMC  will 
need  to  be  altered. 

The  above  searches  do  not  occur  if  a  search  of  HIST  finds  a  routine 
by  the  name  of  DBASE.  In  this  case,  the  search  starts  at  that  address 
and  continues  for  300  octal  locations.  The  lower  half  of  word  7  of 
the  dispatcher  contains  the  address  of  a  10-word  table,  called  ILIST, 
which  points  to  conditionally  loaded  routines  in  the  dispatcher.  The 
first  word  of  each  routine  is  a  BCD  constant  identifying  that 
routine.  During  system  startup,  the  dispatcher  conpresses  itself  to 
eliminate  unnecessary  routines  (e.g.  priority  B  if  bit  18  in  word  0  is 
not  set).  The  search  by  absolute  locations  is  done  only  if  a  search 
of  ILIST  does  not  find  the  desired  routine. 

Upon  finding  the  above  sets  of  instructions,  GMC  searches  the 
dispatcher  area  for  8  free  locations  in  which  to  create  two  new  direct 
transfer  traces.  This  search  begins  at  octal  location  3540  in  WW6.4 
or  4470  in  WW7.2  and  continues  until  octal  location  3740  in  WW6.4  or 
4670  in  WW7.2.  If  8  words  of  free  space  are  not  found,  an  N7  abort 
will  occur.  In  this  case,  the  user  should  examine  the  patch  deck  and 
a  listing  of  the  patches  on  the  total  edit  tape  to  see  if  a  large 
number  of  patches  have  been  made  to  the  dispatcher.  If  this  is  the 
case,  the  dispatcher  code  will  need  to  be  reassembled  in  order  to 
remove  these  patches  or  else  the  Monitor  will  not  be  able  to  be 
utilized.  The  user  does  have  another  alternative.  This  alternative 
involves  patching  word  0  of  the  dispatcher  in  order  to  generate  a  user 
patch  area.  The  patch  involves  the  setting  of  bit  2  to  a  1  in  word  0 
of  the  dispatcher.  No  other  modification  by  the  user  Is  necessary. 

In  this  case,  GMC  will  search  the  dispatcher  from  octal  location  4150 
in  WW6.4  or  5300  in  WW7.2  through  octal  location  4300  in  WW6.4  or  5430 
in  WW7.2  after  checking  word  0  to  insure  that  bit  2  has  been  set. 

The  MSM  collects  sufficient  information  so  as  to  be  able  to  completely 
monitor  the  usage  of  the  entire  disk  subsystem,  the  usage  of  SSA  Cache 
core  and  the  usage  of  FMS  catalog  cache,  when  active.  When  either  the 
MSM  or  CM  Is  active,  a  record  containing  device  names  and  addresses  is 
written  at  the  beginning  of  the  GMC  run  and  periodically  afterward  if 
device  names  change.  This  is  done  only  for  nass  store  devices.  Every 
time  the  system  Issues  a  connect  request  to  a  tape  drive  or  disk 
drive,  sufficient  information  is  collected  so  as  to  be  able  to 
identify  who  Is  issuing  the  connect,  the  file  being  connected  to,  the 
pack  upon  which  the  file  is  located,  the  parameter  types  for  the  file 
being  connected  to  and  the  reason  for  the  connect,  i.e  read,  write, 
write  verify,  etc. 
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Whenever  a  MME  is  issued  the  MSM  will  check  whether  it  is  a  systen  job 
issuing  a  MME  GEFSYE.  For  purposes  of  this  check  a  systen  job  is 
considered  to  be  any  job  with  a  program  number  less  then  octal  15.  If 
the  Peripheral  Allocator  is  issuing  the  GEFSYE,  information  is 
collected  as  to  the  SNUMB  the  Peripheral  Allocator  is  working  for,  and 
the  file  code  that  is  being  GEFSYE 'd.  If  the  GEFSYE  type  is  a  2,  3, 

4,  5,  8,  9,  10,  11,  18,  19,  20,  22,  23,  27,  28,  or  a  29  then 

additional  information  is  collected  so  as  to  be  able  to  determine  the 
CAT/FILE  string  of  the  file  being  GEFSYE'd.  This  information  will  be 
used  by  the  data  reduction  program  to  correlate  file  codes  used  by 
jobs  to  the  actual  CAT/FILE  string  being  referenced  by  a  job.  Also, 
sufficient  information  is  collected  so  as  to  be  able  to  report  how 
many  FILSYS  connects  are  required  in  order  for  the  systen  to  be  able 
to  allocate  and  deallocate  files  requested  by  a  job. 

If  FMS  catalog  cache  is  active  then  the  MSM  will  generate  a  record 
type  octal  77  with  sufficient  data  as  to  be  able  to  monitor  the  effect 
of  FMS  catalog  cache.  This  record  is  generated  once,  for  every  5000 
connects  issued  by  the  system.  This  is  not  a  physical  trace  that  is 

being  generated  and,  as  such,  does  not  need  to  be  present  on  the 

$  TRACE  card.  Rather,  it  is  merely  a  data  record  that  is  being 
written  to  tape  and  given  the  unique  number  of  octal  77.  The  data 
record  consists  of  a  dump  of  some  internal  performance  parameters 
maintained  by  the  GCOS  system. 

5.2.3  CPU  Monitor.  The  CPU  Monitor  (CPUM)  is  used  to  collect  data  on 
CPU  utilization.  For  a  detailed  description  of  reports  containing 
data  collected  by  this  monitor,  see  section  11.  When  the  user  desires 
that  the  CPUM  be  active,  GCOS  trace  types  (octal)  10,  11  and  21  must 
be  enabled  in  the  computer  system  boot  deck  on  the  $  TRACE  card.  CPUM 
processes  trace  types  10,  11,  21,  and  70  to  build  its  records  which 
are  passed  to  ER.  A  separate  discussion  of  the  format  of  the  CPUM 
collected  data  records  is  contained  in  subsection  5.4.4.  Trace  type 
70  is  a  direct  transfer  trace,  created  by  the  GMC,  and  as  such,  need 
not  be  defined  on  the  $  TRACE  card.  The  CPUM  requires  that  at  least 
the  following  segment  numbers  from  table  5-3  be  used  to  generate  the 
GMC  R*  file:  1,  4,  11,  13,  15,  16,  19,  20,  23,  and  28.  The  complete 
process  for  generating  an  R*  file  is  described  in  subsection  5.6.  The 
CPU  Monitor  searches  the  dispatcher  for  an  ASA  .SALT, 5  instruction  and 
then  inserts  code  to  generate  a  direct  transfer  trace  into  GMC.  In 
order  to  capture  subdispatch  processor  time,  it  also  searches  for  a 
STQ  .QT0D.4  instruction  and  then  inserts  code  to  make  a  direct 
transfer  into  GMC.  In  the  T70  capture  routine,  the  time  Increment 
will  be  negative  for  a  regular  dispatch  and  positive  for  a 
subdispatch.  The  subdispatch  processing  is  done  only  when  under  a 
WW7.2  release. 

The  search  for  the  ASA  .SALT, 5  ranges  between  octal  locations  1500  and 
1700  in  WW5.4  or  2300-2340  in  WW7.2  within  the  dispatcher.  The  search 
for  the  STQ  .QT0D,4  instruction  ranges  between  octal  locations  2340 
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and  2400.  If  GMC  cannot  find  the  ASA  .SALT, 5  instruction,  it  will 
abort  with  an  Ml  abort;  if  it  cannot  find  the  STQ  instruction  it  will 
abort  with  an  N8  abort.  If  either  abort  occurs,  the  dispatcher  code 
should  be  examined  to  determine  if  either  instruction  has  been 
modified,  moved,  or  patched.  If  so,  the  code  in  GMC  will  need  to  be 
modi fied. 

Upon  finding  these  instructions,  GMC  searches  the  dispatcher  patch 
area(s)  for  four  free  locations  under  WU6.4  or  eight  free  locations 
under  WW7.2  in  which  to  create  a  direct  transfer  trace  into  the  GMC. 
This  search  has  the  same  ranges  as  that  for  SSA  cache  in  MSM.  If 
patch  space  is  not  found,  an  N2  abort  will  occur.  See  subsection 
5.2.2  for  user  alternatives  should  this  abort  occur. 

The  CPU  Monitor  tracks  the  CPU  usage  of  all  system  programs  and 
accumulates  CPU  usage  of  slave  jobs  into  a  single  value  (see 
subsection  5.4.4).  If  the  user  desires,  he  can  specify  up  to  three 
slave  jobs  for  which  he  wants  the  CPU  monitor  to  track  CPU  usage,  just 
as  it  does  for  system  jobs.  Subsection  5.5.5.  describes  this  user 
option. 

5.2.4  Tape  Monitor.  The  Tape  Monitor  (TM)  is  used  to  collect 
utilization  statistics  on  magnetic  tape  drive  activity.  A  separate 
discussion  of  the  format  of  the  TM  collected  data  records  is  contained 
in  subsection  5.4.5.  Reports  containing  data  collected  by  this 
monitor  are  described  in  section  11. 

When  the  user  desires  that  the  TM  be  active,  GCOS  trace  types  (octal) 
50,  51,  and  52  should  be  enabled  in  the  computer  system  boot  deck  on 
the  $  TRACE  card.  TM  processes  these  trace  types  to  build  its  records 
which  are  passed  to  the  ER.  The  TM  requires  that  at  least  the 
following  segment  numbers  from  table  5-3  be  used  to  generate  the  GMC 
R*  file:  1,  7,  11,  19,  23,  and  29.  The  complete  process  for 
generating  an  R*  file  is  described  in  subsection  5.6. 

5.2.5  Channel  Monitor.  The  Channel  Monitor  (CM)  is  used  to  measure 
I/O  channel  activity  over  tape  and  disk  channels  and  contention  to 
disk  devices.  A  separate  discussion  of  the  format  of  the  CM  collected 
data  records  is  contained  in  subsection  5.4.6.  See  section  8  for  a 
description  of  reports  containing  data  collected  by  this  monitor. 

When  CM  is  active,  it  is  essential  that  GCOS  trace  types  (octal)  4,  7, 
15,  and  22  are  enabled  in  the  computer  system  boot  deck  on  the 
$  TRACE  card.  CM  processes  these  trace  types  to  build  its  records, 
which  are  passed  to  the  ER.  The  CM  requires  that  at  least  the 
following  segment  numbers  from  table  5-3  be  used  to  generate  the  GMC 
R*  file  :  1,  6,  11,  19,  23,  31,  32,  and  33.  The  complete  process  for 

generating  an  R*  file  is  described  in  subsection  5.6. 

Actually,  when  the  CM  Is  active,  sufficient  data  is  processed  for 
obtaining  reports  not  only  from  the  Channel  Monitor  but  also  from  the 
Mass  Store  Monitor.  The  only  Mass  Store  Monitor  data  that  cannot  be 
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and  2400.  If  GMC  cannot  find  the  ASA  .SALT, 5  instruction,  it  will 
abort  with  an  Ml  abort;  if  it  cannot  find  the  ST Q  instruction  it  will 
abort  with  an  N8  abort.  If  either  abort  occurs,  the  dispatcher  code 
should  be  examined  to  determine  if  either  instruction  has  been 
modified,  moved,  or  patched.  If  so,  the  code  in  GMC  will  need  to  be 
modi fied. 

Upon  finding  these  instructions,  GMC  searches  the  dispatcher  patch 
area(s)  for  four  free  locations  under  WW6.4  or  eight  free  locations 
under  WW7.2  in  which  to  create  a  direct  transfer  trace  into  the  GMC. 
This  search  has  the  same  ranges  as  that  for  SSA  cache  in  MSM.  If 
patch  space  is  not  found,  an  U2  abort  will  occur.  See  subsection 
5.2.2  for  user  alternatives  should  this  abort  occur. 

The  CPU  Monitor  tracks  the  CPU  usage  of  all  system  programs  and 
accumulates  CPU  usage  of  slave  jobs  into  a  single  value  (see 
subsection  5.4.4).  If  the  user  desires,  he  can  specify  up  to  three 
slave  jobs  for  which  he  wants  the  CPU  monitor  to  track  CPU  usage,  just 
as  it  does  for  system  jobs.  Subsection  5.5.5.  describes  this  user 
option. 

5.2.4  Tape  Monitor.  The  Tape  Monitor  (TM)  is  used  to  collect 
utilization  statistics  on  magnetic  tape  drive  activity.  A  separate 
discussion  of  the  format  of  the  TM  collected  data  records  is  contained 
in  subsection  5.4.5.  Reports  containing  data  collected  by  this 
monitor  are  described  in  section  11. 

When  the  user  desires  that  the  TM  be  active,  GCOS  trace  types  (octal) 
50,  51,  and  52  should  be  enabled  in  the  computer  system  hoot  deck  on 
the  $  TRACE  card.  TM  processes  these  trace  types  to  build  its  records 
which  are  passed  to  the  ER.  The  TM  requires  that  at  least  the 
following  segment  numbers  from  table  5-3  be  used  to  generate  the  GMC 
R*  file:  1,  7,  11,  19,  23,  and  29.  The  complete  process  for 
generating  an  R*  file  is  described  in  subsection  5.6. 

5.2.5  Channel  Monitor.  The  Channel  Monitor  (CM)  is  used  to  measure 
I/O  channel  activity  over  tape  and  disk  channels  and  contention  to 
disk  devices.  A  separate  discussion  of  the  format  of  the  CM  collected 
data  records  is  contained  in  subsection  5.4.6.  See  section  8  for  a 
description  of  reports  containing  data  collected  by  this  monitor. 

When  CM  is  active,  it  is  essential  that  GCOS  trace  types  (octal)  4,  7, 
15,  and  22  are  enabled  in  the  computer  system  boot  deck  on  the 
$  TRACE  card.  CM  processes  these  trace  types  to  build  its  records, 
which  are  passed  to  the  ER.  The  CM  requires  that  at  least  the 
following  segment  numbers  from  table  5-3  be  used  to  generate  the  GMC 
R*  file  :  1,  6,  11,  19,  23,  31,  32,  and  33.  The  complete  process  for 

generating  an  R*  file  is  described  in  subsection  5.6. 

Actually,  when  the  CM  is  active,  sufficient  data  is  processed  for 
obtaining  reports  not  only  from  the  Channel  Monitor  but  also  from  the 
Mass  Store  Monitor.  The  only  Mass  Store  Monitor  data  that  cannot  be 
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collected  would  be  the  data  needed  to  analyze  Cache  Memory.  If  the 
user  also  wants  this  data  to  be  collected,  he  should  create  an  R*  file 
from  the  following  segments  (see  table  5-3):  1,  3,  6,  11,  14,  15,  18, 

19,  22,  23,  31,  32,  and  33.  In  addition,  the  Mass  Store  Monitor  must 
be  made  active.  There  is  an  additional  option  available  with  the 
Channel  Monitor.  This  option  allows  the  Channel  Monitor  Data 
Reduction  Program  to  produce  a  CPU  Idle/10  Active  Report.  This  report 
is  described  in  section  8.  To  obtain  this  report,  the  Idle  Monitor 
must  be  included  in  the  R*  file.  In  addition,  all  Idle  Monitor  traces 
must  be  active.  The  following  segnents  are  required  to  generate  the 
R*  file:  1,  6.  10,  11,  19,  23,  24,  25,  31,  32,  and  33. 


5.2.6  Cormuni  cations  Analysis  Monitor.  The  Coarunications  Analysis 
Monitor  (CAM)  is  used  to  measure  machine  and  user  response  time  and 
terminal  usage.  A  separate  discussion  of  the  format  of  the  CAM 
collected  data  records  is  contained  in  subsection  5.4.7.  The  complete 
process  for  generating  an  R*  file  is  described  in  subsection  6.6.  The 
output  reports,  containing  data  collected  by  CAM,  are  described  in 
section  9.  When  CAM  is  .;tive,  it  is  essential  that  tne  GfC  generated 


trace  type  (octal)  14  is  enabled  m  the 
the  S  TRACE  card.  CAM  patches  the  Othht 
looking  for  a  l 00  h.LlO.J  nttructton 
instruction.  When  the  mon'tor  s  ter 
patches  from  the  system.  AM  * 

segment  numbers  from  table  5  * 

1,  5,  11,  12.  15.  ",  -• 

The  method  used  by  ** 

by  the  CPUH  to  patch  th*  j  . * 
the  LOO  M.LI0.3  instruct 
ending  at  octal  location  bOuu 
GMC  will  abort  with  an  ID  ab*>rt 
DNWW/MDNET  code  should  be  examined  to  ^ 
moved  out  of  the  octal  rant)*  5000  *000 
If  so,  the  code  in  CAM. PAT  will  need  to 


computer  system  boot  deck  on 
MOMfT  'n  a 7 . ? )  module, 

'  ’owed  by  an  AM)  >0077777 , DU 

ed.  f AM  removes  these 
hat  at  least  the  following 
aerate  the  R*  file: 


'  s i mi i ar  to  that  used 
hes  DNUW/MDNCT  for 
nation  5000  and 
♦ i nd  this  instruction, 
t>ro*lem  occurs,  the 
<f  this  instruction  has  been 
4m  to  an  edit  or  recompile, 
be  altered. 


Upon  finding  this  instruction,  CAM  then  searches  DNMW/MDNCT  patch  area 
for  10  free  locations  in  which  to  create  a  new  system  trace  type  14. 
This  search  begins  at  octal  location  11020  and  continues  for  140  octal 
locations.  If  10  free  words  of  space  are  not  found,  then  seven  words 
of  patch  space  are  searched  for  within  the  dispatcher.  This  search 
occurs  between  octal  locations  3540-3740  In  K5.4  or  4470-4670  in 
W7.2.  If  no  space  is  found  by  either  of  these  searches  an  N4  abort 
will  occur.  In  this  case,  the  user  should  examine  the  patch  deck  to 
see  if  a  large  number  of  patches  have  been  made  to  ONWW/MDNET.  if 
this  is  the  case,  DNWW/MOfCT  will  need  to  be  re-edited  in  order  to 
remove  these  patches  or  else  the  CAM  will  not  be  able  to  be  utilized. 
If  a  specific  terminal's  traffic  Is  to  be  monitored  (see  subsection 
5.5.3),  the  CAM  will  insure  that  no  more  than  two  terminal  IDs  have 


5-16 


been  included.  Invalid  terminal  IDs,  extra  terminal  IDs  or  terminal 
IDs  without  the  CAM  input  option  request  will  cause  the  GMC  to  abort 
with  a  CD,  CO,  or  ET  abort.  See  table  5-2  for  the  meaning  of  these 
aborts. 

5.2.7  GPJS  Monitor.  The  purpose  of  the  GRTS  Monitor  (GRTM)  is  to 
collect  statistical  data  to  be  used  in  evaluating  the  performance  of 
the  DATAMET  355  Front-End  Processor  (FEP).  This  data  includes  CPU 
Utilization,  Response  Time,  and  Terminal  Performance.  The  collected 
information  is  sent  to  the  GMC  within  the  H6000,  which  writes  the  data 
to  tape.  A  separate  discussion  of  the  format  of  the  GRTT1  collected 
data  records  is  contained  in  subsection  5.4.8.  This  tape,  containing 
GRTM  performance  data  and  possibly  data  from  other  monitors,  is  used 
as  input  to  a  data  reduction  program  used  to  produce  statistical 
reports.  (See  section  10). 

5. 2. 7.1  Configuration  Requirements.  The  GRTM  will  execute  on  H6000 
svsten  with  up  to  eight  FEP s.  The  monitor  is  designed  to  run  on  the 
GRTS  II  Phase  IIA  (GRTS  1.2)  FEP  software. 

5. 2. 7. 2  H6000  Conf i guration  Requi rements.  To  run  GRTM,  GCOS  trace 
type  (octal)  62  must  be  enabled  via  the  H6000  computer  system  boot 
deck  on  the  $  TRACE  card.  The  GRTM  requires  that  at  least  the 
following  segment  numbers  from  table  5-3  be  used  to  generate  the  GMC 
R*  file:  1,  8,  11,  19,  23,  34,  and  35.  The  complete  process  for 
generating  an  R*  file  is  described  in  subsection  5.6. 

5 .2.7.3  Altering  of  Phase  1 l- A  Software.  To  use  the  GRTM,  the  user 
must  modify  the  standard  GRTS  software  by  applying  a  set  of  alters 
supplied  with  release  of  the  GJC  software.  It  should  be  noted  that  in 
Release  WW7.2  the  alter  cards  to  support  the  monitor  may  be  included 
within  the  standard  release.  If  this  is  the  case  then  only  the 
following  procedures  need  to  be  followed.  The  user  must  check  the 
FMAC  module  to  insure  that  variable  FMON  has  been  set  to  1.  The  FMAC 
module  must  be  recompiled  and  the  macro  library  reloaded.  Finally, 
all  the  GRTS  modules  should  be  recompiled.  The  user  should  check  the 
release  bulletin  to  confirm  whether  the  required  alters  have  been 
included  within  the  standard  release.  Upon  completing  this  procedure 
the  user  should  refer  to  subsection  5. 2. 7. 4.  If  an  old  GRTS  release 
is  being  edited,  the  user  should  execute  the  following  procedure. 

Files  needed  in  order  to  assemble  the  GRTS  modules  are  contained  under 
catalog  B29ICPX0/GMFC0L/GRT/ALTER.  The  object  decks  created  from  the 
reassembly  of  the  GRTS  modules  are  contained  under  catalog 
B29IDPX0/GMFC0L/GRT/08JECT.  Both  subcatalogs  are  included  on  the  GMF 
save  tape.  (See  figure  5-2.) 
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Figure  5-2.  (Part  2  of  2) 


The  procedures  for  installing  the  GRTS-II  modules  needed  by  the  data 
collector  is  as  follows: 

a.  Install  GRTS-II  Phase  IIA  from  the  IMCV  tape  included  in  the 
system  release  tapes. 

b.  Do  a  series  of  RUNS  of  file  B29IDPX0/GMFC0L/GRT/AL TER/ INSTALL 
to  submit  jobs  which  reassemble  the  GRTS  modules. 

c.  Create  new  spawn  files  which  reference  the  newly  created  GRTS 
object  files  and  which  contain,  in  the  GRTS  configuration  cards,  the 
card  “$  GOPT  RCSMON." 

The  JCL  skeleton  for  reassembling  a  GRTS-II  module  is  as  follows: 

10##N 

20$: I DENT: P WIN, INST -GRTS 

30$ : PROGRAM : SALT, 0M5 ,NGMAC .DECK , LSTOU 

40$:LIMITS:10,65K, ,20K 

50$:PRWrL:C*,W,S,B29IDPX0/GMFC0L/GRT/0BJECT/XXX 

60$ : PRFFL :**,R,R .GRTSI I /F ASTMAC 

70$ : PRMFL : M*. R , S .GRTSI I/S .GRTSI I 

80$: DATA: I*. .COPY 

90$:SELECTA:GRTSI I/ALT/FXXX 

100$:SELECTA:B29IDPX0/GMFC0L/GRT/ALTER/XXXALT 

110$:ENDC0PY 

120$:ENDJ0B 

The  file  (/ALTER/ INSTALL)  may  need  to  be  edited  if  the  IDENT 
information  needs  to  be  changed  or  If  the  GRTS-II  files  are  installed 
under  a  userid  other  than  GRTSI I.  The  installation  IMCV  tape  creates 
catalog  GRTSI I/ALT,  which  contains  alters  to  each  of  the  GRTS-II 
modules.  The  skeleton  JCL  stream  concatenates  the  alters  necessary  to 
run  the  GRTS-II  monitor  to  these  standard  alters.  The  following  will 
submit  jobs  which  reassemble  the  GRTS  modules: 

EDIT  OLD  B29IDPX0/GMFC0L/GRT/ALTER/INSTALL.R 
RS:/XXX/;*:/CCP/ 

RUN 

OLD  INSTALL 
RS:/XXX/;*:/EXC/ 

RUN 

OLD  INSTALL 
RS:/XXX/;*:/CIP/ 

RUN 

OLD  INSTALL 
RS:/XXX/;*:/INT/ 

RUN 


OLD  INSTALL 
RS:/XXX/;*:/ICM/ 

RUM 

OLD  INSTALL 
RS:/XXX/;*:/SUB/ 

RUN 

OLD  INSTALL 
P.S:/XXX/;*:/HCB/ 

RUN 

DONE 

The  following  JCL  is  typical  of  a  GRTS-II  spawn  file: 

$  LOWLOAD 

$  OPTION  NOSETU.NOFCB 

S  SELECT  GRTSII/FDBL 

S  SELECT  GRTSI I/FDLD 

$  EXECUTE  DUMP.0N5 

GRTSI I 

$  LIMITS  20.26K, ,10K 

$  SYSOUT  LP 

$  PRIVITY 

$  DATA  CR ,  .COPY 

$  OPTION  SYMREF 

$  ENTRY  FI NT 

$  SELECTD  GRTSI I/OBJ/CCP 

(configuration  cards) 

$  SELECTD  GRTSI I /OBJ /EXC 

S  SELECTD  GRTSI I /OBJ /TTY 

$  SELECTD  GRTSII/OBJ/LSA 

$  SELECTD  GRTSI I/OBJ /VIP 

$  SELECTD  GRTSII/OBJ/HDL 

$  SELECTD  GRTSI I/OBJ /PWI 

$  SELECTD  GRTSII/OBJ/PLA 

$  SELECTD  GRTSI I /OBJ /RC I 

$  SELECTD  GRTSI I /OBJ /RHP 

$  SELECTD  GRTSI I/OBJ/RLP 

$  SELECTD  GRTSII/OBJ/HNP 

$  SELECTD  GRTSI I/OBJ /CLT 

$  SELECTD  GRTSI I /OBJ/TCP 

$  SELECTD  GRTSI I/OBJ /HCB 

$  SELECTD  GRTSII/OBJ/CIP 

S  SELECTD  GRTSI I/OBJ /SU8 

$  SELECTD  GRTSI I /OBJ /TBL 

$  SELECTD  GRTSI I/OBJ /ICM 

$  SELECTD  GRTSI I /OBJ /I NT 

$  ENDCOPY 

***EOF 

(This  is  the  sample  JCL  file  contained  on  thp  GRTS-II 
installation  IHCY  tape.) 


Such  a  file  must  be  edited  to  replace  the  references  to 
GRTSI I/OBJ/CCP,  / EXC,  /CIP,  /SUB,  /ICM,  /HCB,  and  /INT  by 
B29IDPX0/GMFC0L/ GRT/OBJECT/CCP ,  /EXC,  /CIP,  /SUB,  /ICM,  /HCB,  and  /INT. 

5. 2. 7. 4  FEP  Configuration  Requirements.  The  modified  GRTS  II 
software  will  produce  performance  data.  These  modi fications  are  then 
enabled  in  the  software  through  the  use  of  the  following  control  card 
during  FEP  system  initialization: 

CC1 

1  8  16 

$  GOPT  RCSNON 

Wien  the  monitor  is  not  running,  the  FEP  will  function  normally. 
Execution  of  the  GRTM  is  initiated  by  the  H6000  as  it  connects  to  each 
FEP  to  be  monitored.  At  that  time,  instructional  parameters  are  sent 
to  each  FEP  to  be  used  in  determining  the  amount  of  buffer  space 
needed  for  the  collection  of  the  statistical  data. 

The  GRTM  software  when  configured  will  require  an  additional  1 ,0C0 
(decimal)  words  of  DATANET  main  memory  to  execute.  This  core 
requirement  can  grow  to  as  much  as  2,500  decimal  words  depending  upon 
the  input  options  selected.  The  main  portion  of  the  monitor  code  will 
be  resident  within  the  GRTS  II  FSUB  module  with  additional  patches 
being  incorporated  within  the  FCCP,  FEXC,  FCIP,  FIMT,  FICM,  and  FHCB 
modules.  It  should  be  noted  that  when  the  monitor  is  not  assembled, 
the  1-2K  of  core  required  for  the  monitor  will  be  available  for  buffer 
space.  This  should  be  kept  in  mind  when  reviewing  the  output  reports. 

5.2. 7.5  Interface  Requirements.  During  its  initial ization  phase,  the 
GRTM  software  will  attempt  to  log  onto  the  H6000  system  via  a  pseudo- 
terminal  that  is  used  in  its  interaction  with  the  host-resident  GMC 
program.  Due  to  .MSECR  requirements,  the  pseudoterminal  attempting  to 
gain  access  to  the  system  must  be  on  a  .MSECR  configured  SYSTEM  HSLA 
subchannel.  The  Physical  Terminal  Address  (PTA)  used  by  the  pseudo 
terminal  is  unique  and  therefore  cannot  be  configured  in  the  GRTS  II 
configuration  deck  for  any  other  purpose. 

The  format  of  this  PTA  word  is  as  follows: 


BITS 

MEANING 

0-3 

IOM  CHANNEL  NUMBER  OF  HSLA 

4-5 

HSLA  NUMBER  (1,2,3) 

6-10 

HSLA  SUBCHANNEL  NUMBER  (0-31 ) 

11-15 

POLLED  SCREEN  NUMBER 

16-17 

MUST  BE  ZERO 

As  an  example,  a  PTA  value  of  317200  would  be  used  to  identify  the 
pseudo  terminal  as  being  on: 


IOM  CHANNEL  NUMBER  OF 

HSLA  =  6 

HSLA  NUMBER 

=  1 

HSLA  SUBCHANNEL 

=  29 

POLLED  SCREEN  NUMBER 

=  0 

MUST  BE  ZERO 

This  is  the  same  format  used  to  describe  subchannels  within  .MSECR. 

A  user  must  insure  the  setting  of  the  PTA  value  as  circumstances 
demand.  By  using  the  format  shown  above,  the  symbolic  location  PTA 
located  in  the  file  B29IDPX0/GMFC0L/GRT/ALTER/SUBALT  may  be  altered  to 
reflect  the  user's  own  PTA  value.  The  FSUB  module  must  then  be 
reassembled  prior  to  bootloading  the  DATANET. 

5. 2. 7. 6  Abort  Codes.  The  general  abort  codes  listed  in  table  5-2 
apply  to  spec? Fi c  options.  Abort  codes  created  specifically  for  the 
GRTM  are  listed  below. 

GS  =  SSA  processing  error  caused  by  missing  or  invalid  JLIMITS 
card 

GC  =  Invalid  GRTM  options  on  data  card  file  (I*) 

GC  *  Missing  GRTM  option  card 

GD  =  No  FEP  I/O  can  be  performed 

GM  =  GEMORE  unsuccessful  in  getting  needed  buffers 

NOTE:  GM  aborts  occur  if  another  program  occupies  continuous  memory 
just  above  that  of  the  GRTM  when  buffer  space  is  requested  using  MME 
GEMORE.  Increasing  the  ^LIMITS  memory  value  or  loading  the  GRTM 
immediately  after  booting  the  system  will  enhance  the  chances  of 
getting  DATANET  buffers. 

5. 2. 7. 7  DATANET  Monitor  Software  Description.  The  GRTS  II  system 
operating  within  the  da i ANt i  w i i  be  used  in  the  collection  and 
recording  of  various  Internal  resource  information  which  is  then  sent 
to  the  GMC  executing  in  the  host  (6000)  system.  Monitoring  functions 
within  the  DATANET  have  been  separated  into  three  basic  monitoring 
categories: 

a.  CPU  and  Resource  Monitoring 

b.  Host/FEP  Response  Time 

c.  HSLA  Subchannel  Monitoring 


Monitor  information  will  be  passed  between  the  DATANET  and  the  GMC 
program  executing  in  the  host  using  the  normal  FICM  interface. 

5. 2. 7. 7.1  DATANET-HOST  Interface.  The  GRTM  executing  in  the  DATAHET 
will  be  in  the  form  of  a  pseudoterm nal  connected  to  the  DATANET. 

Once  initialized,  the  pseudomonitor  terminal  will  be  as  any  other 
remote  terminal  connected  to  a  Direct  Access  (DAC)  program  in  the  host. 

As  part  of  GRTM  initialization,  the  pseudo  terminal  will  issue  a 
connect-to-slave  request  to  the  DAC  GMC  program  in  the  host.  The  DAC 
connect  name  requested  will  be  the  special  monitor  name  of  GRTMN'X1 
with  the  'X'  being  a  number  from  zero  through  seven  which  corresponds 
to  the  DATANET  (0-7)  that  issues  the  connect  request. 

The  connect-to-slave  request  will  remain  outstanding  until  it  is 
answered  by  an  inquiry  issued  by  the  GMC  program.  Once  the  request 
has  been  answered,  the  GRTM/ GMC  program  connection  will  be  made. 

Since  the  pseudo  monitor  terminal  will  not  be  physically  connected  to 
the  DATANET  (i.e.,  on  an  HSLA  S/C)  the  need  for  a  special  monitor 
"Terminal  Control  Block  (TCB)"  becomes  necessary. 

The  special  monitor  TCB  is  necessary  in  order  to  utilize  the  normal 
FICM  interface  in  the  passing  of  monitor  information  to  the  GMC 
program. 

5. 2. 7. 7. 2  Monitoring  of  CPU.  The  DATANET  Monitor  will  collect  CPU 
and  various  resource  information  by  the  placement  of  conditionally 
assembled  instructions  at  appropriate  points  in  the  ICM  and  EXC 
modules  of  the  GRTS  II  software.  The  information  to  be  collected  at 
the  CPU  level  is  independent  of  the  HSLA  subchannel  and  is  sent  to  the 
host  based  upon  a  predefined  time  sampling  increment  for  writing 
buffers  to  the  host  collector  program.  For  a  given  buffer  sent  to  the 
host,  the  following  information  is  included: 

a.  Time  Idle  -  The  amount  of  time  in  milliseconds  spent  in  the 
exec  idle  loop  since  the  last  buffer  was  sent  to  the  host. 

b.  Buffer  Denials  -  A  cumulative  count  of  buffer  denials.  This  is 
a  count  of  the  number  of  times  that  the  GRTS  II  software  was 
unable  to  get  a  buffer  for  a  user. 

c.  Buffer  Availability  -  The  number  of  18-bit  words  currently 
available  for  buffers. 

d.  Number  of  Users  -  Count  of  the  number  of  users  currently  logged 
on  the  system. 
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e.  Humber  of  Transactions  -  Two  counts  are  maintained  and  sent  to 
the  host: 

(1)  The  accumulated  number  of  transactions  sent  to  the  host,  and 

(2)  The  accumulated  number  of  transactions  received  from  the 
host. 

f.  Size  of  Transactions  -  There  are  two  counts  maintained  and  sent 
to  the  host: 

(1)  A  cumulative  count  of  the  number  of  36-bit  word  sent  to  the 
host,  and 

(2)  A  cumulative  count  of  the  number  36-bit  words  received  from 
the  host. 

g.  Host  RSVPs  Count  -  A  cumulative  count  of  the  number  of  host 
RSVPs  received  by  the  DATAMET. 

h.  Buffer  Requests  -  A  cumulative  count  of  the  number  of  times  the 
buffer  allocation  routine  was  called. 

5. 2. 7. 7. 3  Host/DATANET  Response  Tine.  The  GRTS  II  Monitoring  of  the 
FEP/Host  Response  Time  will  be  measured  on  a  program  name  basis.  For 
this  monitoring,  conditional  coding  will  be  added  to  the  FICM  module 
to  detect  the  various  requests  to  the  Host.  Each  time  that  either  a 
"Connect-to-Sl ave"  or  "Disconnect"  request  is  detected,  the  following 
formatted  entry  will  be  made  into  the  response  time  buffer  area: 

a.  Function  Code 

b.  Type  of  Device/Line  ID 

c.  Time  Stamp 

d.  DAC  Name  (for  connect- to-sl ave  requests  only) 

The  Function  Code  (i.e.,  connect-to-slave,  disconnect)  will  identify 
the  type  of  request  with  the  line  number  entry  identifying  the  logical 
line  number  of  the  device. 

The  GRTM  will  capture  the  following  requests: 

a.  Accept  Direct  Input  (355  asking  H6000  to  accept  data) 

b.  Input  Accepted  (input  received  by  the  H6000) 

c.  Send  Output  (355  requesting  continuation  of  output) 
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d.  Output  Received  (355  has  received  data  from  H6000) 

e.  Output  Started  (355  has  begun  transmitting  data  to  terminal) 

f.  Output  Complete  (355  has  completed  transmission  of  data  to 
terminal ) 

g.  Accept  Direct  Output  (H6000  has  told  355  it  has  data  to  send) 

h.  Accept  Direct  Output,  Then  Input  (HfiOOP  has  told  the  355  it  has 
data  to  send  and  expects  input) 

Each  time  one  of  the  above  requests  or  responses  is  detected,  a 
response  time  buffer  entry  of  the  following  format  is  made: 

a.  Function  Code 

b.  Type  of  Device/Line  ID 

c .  Ti me  S  tamp 

In  placing  both  the  line  number  and  the  time  stamp  in  every  collector 
buffer  entry,  response  times  between  the  various  request  cycles  of 
each  DAC  program  executing  the  host  will  be  effectively  monitored. 

5. 2. 7. 7. 4  Terminal  Monitoring.  CRTS  II  Terminal  Monitoring  will  be 
on  a  HSLA  subchannel  (S/C)  basis.  Every  monitored  HSLA  S/C  will  be 
allocated  a  four  word  (18  bit)  record  area  within  the  output  buffer 
where  the  various  monitor  information  for  the  S/C  is  accumulated. 

Each  word  within  the  S/Cs  record  will  be  a  "predefined"  location  where 
the  various  counts  for  the  S/C  are  held.  The  first  word  of  each  S/C 
record  will  contain  information  as  to  the  HSLA  number  and  the  S/C 
number  to  which  the  record  belongs. 

The  GRTM  will  update  these  various  counts  dynamically  as  they  occur 
within  the  DATANET. 

5.2.8  Idle  ftonitor.  The  Idle  Monitor  (IDLEM)  is  used  to  collect 
data  concerning  CPU  activity.  This  monitor  can  only  be  used  in 
conjunction  with  the  MUM  or  the  CM.  It  should  not  be  activated  if  one 
of  the  two  aforementioned  monitors  is  not  active.  If  the  Idle  Monitor 
is  present  on  the  R*  file  and  active  and  if,  in  addition,  the  MUM  or 
CM  is  not  active,  then  the  IDLEM  will  automatically  be  turned  off. 

The  user  should  read  subsections  5.2.1  and  5.2.5  for  information 
concerning  the  use  of  the  IDLEM.  A  separate  discussion  of  the  format 
of  the  collected  data  records  is  contained  in  subsection  5.4.9. 

5.2.9  Transaction  Processing  System  Monitor.  The  GMC  Transaction 
Processing  System  Monitor  (TpSM)  is  used  to  collect  data  on  the 
performance  of  the  GCOS  Transaction  Processing  Executive  (TPE) 
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Sy stem.  A  separate  discussion  of  the  fomat  of  the  TPSM  collected 
data  records  is  contained  in  subsection  5.4.10.  The  reports 
containing  data  collected  by  TPSM  are  described  in  section  12. 


When  TPSM  is  active,  the  required  traces  must  be  enabled  in  the 
computer  system  boot  deck  on  the  $  TRACE  card  (see  table  5-1).  A 
sample  of  the  reports  and  run  tine  procedures  for  the  data  reduction 
program  can  be  found  in  the  Transaction  Processor  System  section  12. 
The  TPSM  requires  that  at  least  the  following  segment  numbers  from 
table  5-3  be  used  to  generate  the  GMC  R*  file:  1,  9,  11,  19,  23,  and 
36.  The  complete  process  for  generating  an  R*  file  is  described  in 
subsection  5.6. 

5. 2.9.1  TPS  Trace  Collection.  The  TPSM  is  unlike  most  other  GMC 
monitors  in  that  monitoring  of  the  Transaction  Processing  System  is 
controlled  via  the  operator  console.  Prior  to  collecting  data,  the 
user  must  alter  the  TPS  (see  subsection  5. 2. 9. 2)  and  must  also  create 
a  usable  GMC  R*  file  (see  subsection  5.6).  Once  these  actions  are 
performed  and  a  GMC  execution  is  started,  the  user  must  still  perform 
one  additional  action  before  data  collection  can  begin.  The  TPSM  is 
turned  on  or  off  by  the  console  operator  via  the  TP  MESS  command.  The 
operator  must  request  "TP  MESS".  When  the  console  responds  "TP 
MESS?",  the  message  "TRACE  ON"  is  entered  to  start  processing  traces, 
or  "TRACE  OFF"  to  discontinue  trace  processing.  This  procedure  can  be 
repeated  as  often  as  desired.  The  TPSM  is  the  only  GMC  monitor  that 
can  be  turned  on  or  off  while  the  GMC  is  physically  executing. 

5.2. 9.2  Modifying  the  Transaction  Processing  System.  To  use  the 
TPSM,  the  user  must  alter  the  Transaction  Processing  System.  An  alter 
file  is  provided  with  the  GMF  software  delivery.  The  file  name  is 
B29IDPX0/S0URCE/TPEALT.  This  file  contains  all  alters  and  associated 
JCL  necessary  to  modify  the  standard  TPS.  These  modifications  apply 
only  to  the  WW7.2  version  of  TPS.  The  user  will  need  to  make  minor 
modifications  to  the  file  so  as  to  correctly  reference  any  permanent 
files  that  are  required. 

5.3  Processing 

The  GMC  requires  one  tape  drive,  15K-24K  words  of  storage,  and,  if  the 
multireel  option  will  be  used,  300  links  of  disk  storage  to  execute. 
The  actual  memory  required  will  depend  on  the  number  of  monitors 
selected  for  execution.  The  GMC  will  lock  itself  into  memory, 
assuring  that  it  cannot  be  swapped  or  moved  during  the  run  time.  An 
initialization  procedure  will  attempt  to  relocate  GMC  out  of  the 
memory  growth  range  of  Time-Sharing  (TS1)  and,  in  addition,  relocate 
GMC  to  the  high  or  low  end  of  a  quadrant  of  memory.  Due  to  this 


feature,  GMC  can  be  started  at  any  time  of  the  day,  without  fear  of 
causing  memory  fragmentation  or  degraded  TSS  response. 

Immediately  prior  to  beginning  collection  of  data,  GMC  will  attempt  to 
relocate  out  of  the  TSS  (TS1 )  memory  growth  range.  On  a  system  with 
more  than  256K  of  memory,  the  growth  range  of  TSS  (TS1 )  is  assumed  to 
be  180K,  while  on  a  system  with  less  than  256K  of  memory  the  growth 
range  is  considered  to  be  TOOK.  Ouring  this  relocation  procedure  GMC 
might  grow  in  size;  however,  the  user  need  not  be  concerned,  since  GMC 
will  release  all  unneeded  memory  after  the  relocation  operation  is 
completed.  If  GMC  cannot  relocate  out  of  the  growth  range  of  TSS 
(TS1),  the  GMC  will  abort  with  a  CM  abort.  The  user  can  override  this 
abort  wi th  a  data  card  option,  but  he  should  do  so  with  great  care 
since  TSS  response  might  be  severely  degraded  if  GMC  prevents  TSS 
(TS1 )  from  growing  in  size.  The  procedures  for  overriding  the  abort 
can  be  found  in  subsection  5.5.4. 

After  GMC  succeeds  in  relocating  out  of  the  growth  range  of 
Time-Sharing,  GMC  will  attempt  to  relocate  itself  to  the  high  or  low 
end  of  the  memory  quadrant.  It  will  relocate  as  far  away  as  it  can, 
but  it  will  not  abort  if  it  is  unsuccessful.  Therefore,  slight  meaory 
fragmentation  is  still  possible,  but  this  should  cause  little  if  any 
problem  to  the  operation  of  the  computer. 

5.3.1  Executive  Routine.  The  Executive  Routine  (ER)  controls  the 
processing  of  the  GMC.  The  ER  controls  all  inputs,  outputs,  start  and 
stop  time,  and  all  required  error  processing.  The  ER  also  hooks  the 
GMC  into  the  dispatcher. 

The  ER  begins  processing  by  reading  the  input  parameters  on  the  data 
card.  The  procedure  for  determining  the  required  data  card  parameters 
for  GMC  operation  is  fully  described  in  subsection  5.5.  Using  these 
parameters,  ER  determines  which  monitors  will  be  active  during  the 
run.  If  a  start  time  is  specified,  ER  will  remain  idle  until  the 
start  time  is  reached.  During  this  time,  it  is  possible  that  GMC  will 
be  swapped.  The  ER  will  cause  the  GMC  to  terminate  at  a  specified 
stop  time  if  the  option  is  present.  Multireel  output  is  the  standard 
default  for  GMC;  however,  the  user  can  request  GMC  to  terminate  after 
one  or  more  reels  of  data  have  been  collected.  The  ER  controls  all 
error  aborts  within  GMC.  Abort  codes  and  reasons  for  the  abort  are 
shown  in  table  5-2.  When  ER  begins  processing,  it  will  query  the 
operator  for  the  first  tape  number  with  the  message: 

*F0R  XXXXX  WHAT  IS  THE  MOUNTED  TAPE'S  NUMBER? 

where  XXXXX  is  the  SNUMB  assigned  GMC.  The  operator  must  enter  the 
reel  number  of  the  tape  to  be  used  for  GMC  output.  If  the  operator 
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does  not  reply  to  the  message,  the  question  will  be  repeated.  It  is 
important  that  all  tapes  requested  by  GMC  contain  a  write  ring  and  be 
mounted  as  quickly  as  possible. 

The  GMC  will  execute  a  GEWAKE  statement  (and  may  be  swapped)  if  it  is 
not  desired  immediately  (user  has  requested  a  time  option).  When  the 
ER  determines  that  it  is  time  to  begin  monitoring,  it  will  move  the 
GMC  out  of  the  growth  range  of  TSS  (TS1).  Upon  successfully  moving 
GMC,  the  ER  will  issue  a  message  to  the  operator  indicating  which 
monitors  have  been  selected  for  execution.  The  monitors  will  be 
referenced  by  the  mnemonic  code  shown  in  table  5-1. 

For  example  if  the  Mass  Store  Monitor,  Channel  Monitor,  and 
Communications  Analysis  Monitor  are  active,  the  following  message  will 
be  printed: 

♦MONITORS  MSM  CM  CAM 

If  this  message  does  not  appear  within  5  minutes  of  the  monitoring 
start  time,  the  GMC  has  encountered  a  severe  problem  in  its  attempt  to 
move.  Such  a  problem  should  be  a  rare  occurrence.  If  this  problem 
does  occur,  GMC  should  be  termed  and  restarted. 

If  the  multireel  option  (see  subsection  5.5.2)  is  specified  (i.e.,  an 
M9  or  M91  does  not  appear  on  the  GMC  data  card),  the  GMC  will  issue 
the  following  message  to  the  operator  when  it  reaches  the  end  of  a 
reel : 

♦FOR  XXXXX  MOUNT  Y  REEL  ON  111111 
FIRST  TYPE  NEW  TAPE  #  - 

where  XXXXX  represents  the  SNUMB  of  GMC,  Y  represents  the  sequence 
number  of  the  next  data  tape,  and  111111  is  the  tape  drive  address. 
Should  the  operator  be  distracted  for  more  than  30  seconds,  GMC  will 
reissue  the  message. 

Once  the  operator  gives  the  GMC  a  tape  number,  the  ER  rewinds  the  data 
tape  and  waits  one  minute  for  the  tape  to  rewind.  The  ER  then  checks 
the  tape  status,  and  if  the  next  tape  has  not  been  mounted,  the  ER 
issues  the  message: 

♦♦AGAIN  MOUNT  TAPE  *  XXXXX  FOR  MONITOR  YYYYY  ON  111111 

where  XXXXX  is  the  reel  number,  YYYYY  is  the  SNUMB  assigned  to  GMC, 
and  ZZZZZZ  Is  the  tape  drive  address. 

This  procedure  of  waiting  one  minute  and  reissuing  the  message  is 
repeated  until  the  tape  is  mounted.  During  this  timeframe,  the  ER  is 
writing  any  full  buffers  collected  to  its  overflow  disk  file.  Since 
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this  file  can  fill  and  cause  an  abort,  the  operator  should  ensure  that 
the  data  tape  is  mounted  as  soon  as  possible. 

After  the  GMC  processes  the  data  card,  individual  monitor 
initialization  is  accomplished.  After  initialization  is  completed, 
the  memory  used  for  the  initialization  code  is  used  for  buffering  the 
collected  monitor  data  prior  to  it  being  written  to  tape.  GMC  is 
coded  for  extended  memory  systems  with  the  exception  of  nonextended 
memory.  When  nonextended  memory  is  sensed,  the  extended  memory 
instructions  throughout  the  program  are  changed.  If  the 
initialization  is  accomplished  successfully,  GMC  will  "hook"  itself 
into  the  dispatcher  and  become  an  extension  of  the  dispatcher.  The 
normal  system  trace  procedures  consist  of  the  following  three  unique 
instructions: 


LDAQ  **,7* 
STAQ  **,2 
TRA  0,1 


The  GMC  modifies  this  normal  sequence  in  the  case  of  extended  memory. 
Each  trace  event  will  preserve  the  current  MBA  value,  set  the  MBA 
value  for  the  GMC,  and  transfer  to  the  GMC.  The  resulting  interface 
includes  the  following: 


SMBA  MBASTR.7 
LMBA  GMCSMBA.DU 
TRA  GMC. 


The  interface  is  completed  by  execution  of  the 

LDAQ  **,7* 

STAQ  **,2 

in  GMC,  which  completes  the  normal  trace  procedures.  In  a  system  with 
nonextended  memory,  the  interface  is  less  complex,  resulting  in  one 
instruction  change  in  the  trace  procedures.  The 

LDAQ  **,7* 

STAQ  **,2 

TRA  0,1  of  the  trace 

is  altered  to  look  like 

LDAQ  **,7* 

STAQ  **  ,2 
TRA  GMC. 
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Whenever  the  dispatcher  executes  a  trace  after  this  point,  the  ®1C  ER 
will  gain  control  and  pass  the  system  control  over  to  the  proper 
monitor  for  data  collection.  Contro’  is  then  returned  to  the  ER  for 
return  to  the  dispatcher. 

In  the  process  of  collecting  data,  a  monitor  may  desire  to  save  a 
logical  record  on  the  collection  tape.  In  order  to  sequence  all 
logical  records  to  the  tape  file,  a  common  buffering  system  has  been 
provided  by  the  GMC.  Any  monitor  can  pass  control  to  symbol  BUFCTL 
for  buffering  a  logical  record  to  be  saved  on  the  tape  file.  This 
code  is  executed  in  master  mode  as  an  extension  of  the  operating 
system  function  where  control  has  been  taken.  Writing  the  buffered 
data  to  tape  is  a  GMC  slave  function  which  requires  controls  between 
the  buffering  system  and  the  writing  system.  The  buffering  system 
indicates,  via  software  to  the  slave,  when  an  individual  buffer  is  to 
be  written.  After  the  slave  has  written  the  buffer,  it  is  returned  to 
the  buffering  system.  The  slave  code  for  writing  the  tape  is  started 
at  symbol  BUFCHK.  This  slave  portion  is  normally  in  GEUAKE  mode  and 
is  awakened  either  by  GMC  master  mode  code  or  by  a  nomal  dispatch. 

The  slave  Function  will  check  for  a  full  buffer  and  write  it  before 
going  back  to  sleep.  This  process  is  repeated  until  GMC  has  been 
terminated,  at  which  time  the  slave  portion  will  execute  the  proper 
abort  code  via  a  MME  GEBORT.  The  wrap-up  procedure  then  performs  all 
termination  requirements.  GMC  will  terminate  via  direction  From  the 
time  option  on  the  data  card,  limited  reel  option  on  the  data  card  or 
else  via  console  command.  If  no  time  option  or  limited  reel  option 
has  been  selected,  the  GMC  will  continue  to  process  until  it  is 
ABORTED  via  the  console. 

At  termination,  the  wrap-up  location  is  given  control  and  the 
termination  record  is  processed.  This  is  the  slave  termination  of 
GMC.  Also  associated  with  termination  is  the  return  of  the  dispatcher 
code  to  its  original  state.  This  is  accomplished  by  GMC  checking  its 
own  .STATE  word  for  a  termination  code.  When  the  termination  code  is 
sensed,  the  dispatcher  hook  is  removed,  the  original  code  is  replaced, 
and  the  slave  termination  process  is  completed.  Upon  termination,  ER 
reads  the  communication  region  table,  writes  the  data  to  tape  with  a 
termination  record,  removes  any  patches  it  has  placed  in  the  system, 
and  proceeds  to  wrap  up. 

5.3.2  Output.  Output  of  GMC  is  always  a  magnetic  tape  file.  The 
f ol 1 owi ng  is  a  guideline  for  the  number  of  tapes  generated  by  each 
monitor  (800  BP  I,  2400  feet  tape  reels): 

MUM  -  one  tape  every  6-8  hours.  With  Idle  Monitor,  one  tape 
every  3  hours. 

MSM  -  one  tape  every  hour 
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CPUM  -  1  tape  every  24  hours 

TM  -  1  tape  every  24  hours 

CM  -  1  tape  every  half  hour 

TPSM  -  1  tape  every  four  hours 

CAM  -  1  tape  every  eight  hours 
GRTM  -  1  tape  every  24  hours 

Analysis  of  this  tape(s)  is  acconplished  by  a  series  of  dedicated  data 
reduction  programs  which  are  discussed  in  sections  6  through  12.  It 
is  essential  that  the  proper  data  reduction  program  is  run  against 
data  created  by  its  associated  monitor  routine. 

The  GMC  is  usually  terminated  by  operator  request.  However,  there  are 
tines  when  the  monitor  may  terminate  itself.  In  most  of  these  cases, 
the  operator  will  receive  a  console  message  indicating  the  reason  for 
the  abort  (see  table  5-2).  However,  under  some  ci rcunstances  the 
message  the  operator  sees  is  that  GMC  terminated  with  "NO  REASON 
SPECIFIED."  In  this  case,  if  the  job  listing  is  examined,  a  reason 
will  be  given  under  the  WRAPUP  activity  information  as  shown  below. 

*  ACTY-01  $  CARD  #0008*  GELOAD  03/16/78  SW= 000000000000 
NO  REASON  SPECIFIED  AT  030440  1=5060  SW= 000000000000 

♦WRAPUP  BEGUN 

(USERS  BS  MME  GEBORT)  AT  031413  1=0000  SW=000000000000 
5.4  GMC  Data  Records 

5.4.1  GMC  Executive.  The  GMC  Executive  produces  -.n  i  ni ti J  cation 
record  that  must  be  read  by  every  data  reduction  program.  This  record 
contains  information  on  the  system  configuration  and  the  status  of 
various  queues  at  the  tine  the  monitor  started.  The  length  of  the 
record  is  dependent  on  the  size  of  the  configuration.  The  Executive 
also  writes  a  termination  record  whenever  it  terminates  normally. 


Ini  ti al  1 zation  Record 


Word 

Bits 

Information 

1 

0-35 

Block  Control 

2 

0-35 

Zero 

3 

0-17 

Year  (.CRJCD) 

18-35 

Julian  day  (.CRJCD) 

4 

Not  used 

5 

0-35 

Current  date  (.CROAT) 

6 

0-35 

Current  time  (.CRTOD) 

7 

0-35 

Reg  A  of  RSCR  32 
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8 

0-35 

Reg  Q  of  RSCR  32 

9 

0-35 

Softv/are  release  (.CRSR) 

10 

0-17 

Size  of  HCM  { .CRHCL) 

18-35 

Not  used 

11 

0-35 

I/O  Channel  limits  (.CRICL) 

12 

0-35 

Hardware  IOM  type  .CRIOC 

13 

0-17 

Not  used 

18-35 

Memory  size  (.CRMSZ) 

14 

0-17 

Tape  sieve  parameter  (.CRMTP) 

18-35 

Link  sieve  parameter  (.CRMTP) 

Number  of  IOM's  configured  (.CRNIC) 

15 

0-17 

18-35 

Length  of  system  file  table  (2  words 
per  file) 

16 

0-17 

Number  of  processors  configured  (.CRNPC) 

18-35 

Shared  System  Number  (.CRSSN) 

This  value  applicable  only  if  bit  2  in 
word  19  is  set. 

17 

0-35 

CPU  type  (RSW  2  instruction) 

18 

0-35 

BCD  System  ID  (.CRSID) 

19 

0-35 

System  configuration  (.CRFIG) 

20 

0-17 

1st  user  program  number  (15  for  WWMCCS,  set 
by  FSTSLV ) 

18-35 

first  program  number  for  GEIN  (64  -  number 
of  card  readers) 

21 

0-35 

GMF  LAL  and  full  size  ( . SALIM+1 ) 

22 

0-17 

Gff  program  number 

18-35 

Zero 

23 

0-35 

Idle  time  for  processor  0  (.CRIDT) 

24 

0-35 

Overhead  time  for  processor  0 
(above  2  words  are  repeated  for  each 
configured  processor  (word  16  bits 

0-17)) 

25+ 

0-17 

SCT  address  for  system  file  1 

18-23 

Device  type  for  system  file  1 

24-29 

Device  number  for  system  file  1 

30-35 

Not  used 

26+ 

0-17 

Starting  11  ink  number  on  device  for  system 
file  1 

18-35 

Length  of  system  file  1  in  11  inks 
(word  25+  and  26+  are  repeated  for  each 
system  file.  Total  number  of  words  for 
this  portion  of  record  is  found  in 
word  15  bits  18-35. ) 

27+ 

0-35 

Module  directory  (MDD)  table  address  and 
length  ( .CRMDD) 

28+ 

0-35 

GECALL  name  (GMD)  table  address  and  length 
( .CRGMD) 

29+ 

MDD  table-one  word  per  entry,  plus  one 

extra  word  If  length  is  odd 
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30+ 


GMD  table-one  word  per  entry, 
plus  one  extra  word  if  length  is  odd 
SCT  table  address  {.CRSCT) 

Number  of  devices  described  below 
Hot  used 

SCT  information  for  each  channel  on  each 
IOM.  Since  both  MTS0600  and  HTS0610  tape 
drives  have  the  same  device  type,  bit  25  in 
the  corresponding  .CRCT1  word  is  used.  If 
this  bit  is  set,  then  610  tape  drives  are 
indicated  by  device  types  03  and  04  for 
7-  and  9-track  tape  drives.  The 
length  of  this  portion  of  the  initiali¬ 
zation  record  is  48  times  the  number  of 
IOM's  configured  (word  15  bits  0-17)  plus 
the  contents  of  word  (32+)  bits  0-17. 

GMF  tape  number 

Monitors  active  indicator  -  Bit  i  set 
corresponds  to  monitor  i  active 

Following  the  GMC  initialization  record  is  a  special  record  describing 
the  CPU  configuration,  channel  availability,  and  memory  utilization. 
Depending  on  the  monitors  selected  for  execution  and  on  the  particular 
GCOS  trace  which  first  passes  through  the  dispatcher  "hook,"  a  few 
traces  may  precede  this  record  (e.g.  during  their  initialization 
routines,  the  mass  storage,  channel,  communications,  and  GRTS  monitors 
write  records).  During  the  execution  of  GMC,  this  record  is  written 
again  every  five  minutes.  This  is  done  in  order  to  capture  any 
releasing  or  assigning  of  memory  that  may  have  occurred.  Since  this 
record  is  generated  every  five  minutes,  it  is  possible  that  the 
correct  memory  configuration  will  not  be  available  to  the  data 
reduction  program  for  at  most  a  5-minute  period  of  time.  This  will 
result  in  only  a  minor  distortion  of  reports  and  will  prove 
insignificant.  If  a  central  processing  unit  is  dropped  or  added,  the 
collector  will  recognize  this  fact  immediately  and  generate  this 
reconfiguration  record  immediately.  If  a  channel  or  IOM  is  dropped  or 
added,  this  will  be  reported  by  the  reconf iguration  record  that  is 
generated  every  five  minutes.  It  should  be  noted  that  if  multiple 
changes  occur  within  a  5-mlnute  period,  only  the  final  change  will  be 
reported. 

The  following  communication  region  cells  are  constantly  monitored  for 
changes,  since  a  processor  reconfiguration  may  generate  numerous 
traces  while  it  is  being  performed: 

1.  .CRNPC  -  Lower  half  specifies  number  of  processors  released 

2.  .CRXPC  -  Upper  specifies  processor  dedicated  to  T4D 


31  + 

0-35 

32+ 

0-17 

18-35 

33+ 

0-35 

34+ 

0-35 

35+ 

0-35 

3.  .CRCMC  -  Six-word  processor  assignment  table  naps  logical 
processor  number  to  a  physical  port  on  the  SCU;  table  is 
also  updated  if  a  program  sets  its  .STATE  word  to  force 
execution  on  a  specific  processor. 

4.  .CRMDB  -  Specifies  information  about  SSA  cache;  may  change 
during  a  memory  release  operation. 

Because  of  the  number  of  events  involved  in  reconfiguration,  multiple 
records  may  be  written  for  the  same  reconfiguration.  System  programs 
(e.g.  TAD)  nay  cause  a  record  to  be  written  if  they  withdraw  a 
processor  from  normal  dispatching.  They  may  also  be  written  if  a 
program  sets  its  .STATE  word  to  restrict  it  to  or  from  a  specific 
processor.  Such  a  program  must  also  update  a  counter  within  the 
.CRCMC  table. 

The  format  of  the  reconfiguration  record  is  as  follows: 


Word 

Bits 

Information 

1 

0-17 

Number  of  words  following  (record 
control  word  -  RCW) 

18-35 

Octal  500100  (Special  record) 

2 

0-35 

RSCR  tine 

3* 

0-17 

Number  of  processors  configured  (.CRMPC) 

18-35 

Humber  of  processor  released 

4* 

0-17 

Processor  dedicated  to  T&D  ( . CRXPC ) 

18-35 

Reconfiguration  Flag 

5-10 

0-35 

Processor  assignments  (.CRCMC) 

11 

0-17 

MBA  of  SSA  cache  (.CRMBA)  (zero  if  non- 
extended  memory) 

18-35 

Mot  used 

12 

0-17 

LAL  of  SSA  cache  (.CRMDB) 

18-29 

Size  of  SSA  cache  (#  of  buffers) 

30-35 

Not  used 

13* 

0-8 

Option  word  in  .MFSIO 

9-17 

Number  of  320-word  buffers  for  catalog 
cache 

18-35 

Not  used 

14* 

0-17 

MBA  of  catalog  cache  (entry  point  -9 
of  .MFSIO)  (zero  if  nonextended 
memory) 

18-35 

Absolute  address  of  catalog  cache 

15 


0 


16+ 

17+ 


Flag  (=1  -  Record  written  after  100 
.EXIT  traces  processed  without  match 
on  triggering  .CALL  trace) 

1-17  Code  for  event  triggering  this  record 

1  Initialization  record 

2  5  minute  record 

10  Change  in  .CRNPC  or  .CRXPC  (Not 
monitored  in  WW6.4)* 

11  Change  in  SSA  cache  (.CRMBA  or 
.CRMDB )  If  a  RLSEC  request 
references  the  SSA  cache  buffer,  then 
two  reconfiguration  records  may  be 
generated:  one  for  deallocation  of 
SSA  cache  (.CRMDB)  and  a  second  for 
the  actual  memory  release  (update  of 
.CRPMU  memory  map).  A  further 
reconfiguration  record  will  be 
generated  if  the  SSA  cache  buffer  is 
relocated. 

12  Change  in  processor  assignments 
( .CRCMC ) 

13  Change  in  FMS  options  or  catalog 
cache  (Not  monitored  in  Wl/6.4)* 

18-35  Number  of  words  following  for  channel 

information,  one  word  per  configured 
channel  (.CRCT1) 

0-35  .CRCT1 

0-35  Memory  map  (.CRPMU) 

The  length  of  this  part  of  the  special 
record  is  equal  to  the  length  contained 
in  the  RCW  minus  14  minus  the  contents 
of  bits  18-35  of  word  15. 


♦This  data  is  reported  as  zeros  in  WW6.4. 

When  GMC  terminates.  It  writes  a  record  containing  information  read 
from  comnunlcation  region  cells  and  information  about  the  amount  of 
processor  time  used  by  the  GMC  collector  In  processing  traces  and  also 
by  the  slave  portion  of  GMC  in  performing  its  initialization  and  tape 
I/O.  The  format  of  the  complete  termination  record  is  as  follows. 

Termination  Record 


Word 

Bits 

Infomation 

1 

0-17 

Size  of  record  (-23) 

18-35 

Octal  300100 

5-36 


I 


2 

0-35 

Memory  size  .CRMSZ 

3 

0-17 

Number  of  IOM’s  ( . CRM IC ) 

18-35 

Not  used 

4 

0-17 

Number  of  processors  (.CRNPC) 

18-35 

Not  used 

5 

0-35 

Current  date  (.CRDAT) 

6 

0-35 

Current  time  (.CRT0D) 

7 

0-35 

System  configuration  .CRFIG 

8 

0-35 

Monitor  slave  processor  tine 

a 

0-35 

A  register  from  RSCR  32 

10 

0-35 

0  register  from  RSCR  32 

11 

0-35 

Idle  time  processor  0 

12 

0-35 

Overhead  time  for  processor  0 
(words  11  and  12  are  repeated  for 
each  configured  processor) 

13+ 

0-35 

Number  of  times  through  GMC 

14+ 

0-35 

CPU  time  in  GMC  executive 

15-25+ 

0-35 

CPU  time  in  MUM,  MSM,  CPUM,  TAPE, 
CM,  CAM,  GRTM,  TPE,  IDLEM,  NAME, 
FMS  GEFSY 

26+ 

Not  Used 

5.4.2  MUM.  The  MUM  processes  GCOS  system  trace  types  10,  11,  46  and 
51  by  creating  its  own  data  collection  records  to  describe  the  effect 
of  these  system  events. 

5. 4. 2.1  Trace  Type  10.  This  MUM  generated  record  contains 
sufficient  information  to  describe  the  status  of  every  job  known  to 
the  Peripheral  Allocator  and  Core  Allocator.  Each  job  is  described  in 
program  number  sequence.  The  format  of  a  trace  type  10  GMC  data 
record  is  shown  below.  The  data  in  this  record  is  obtained  from  the 
occurrence  of  a  system  trace  10,  11  or  51  event. 


Word 

Bits 

Information 

1 

0-17 

Number  of  words  following 
(record  control  word) 

18-26 

Not  used 

27-35 

Octal  10  (trace  number) 

2 

0-17 

#  (N)  of  3  word  entries  in  PALC  data  -  if 
both  bits  24  and  25  are  set  to  1 

18-23 

not  used 

24,25 

If  both  set  to  1,  PALC  record 

exists  as  described  below  -  else  PALC  data 

not  present 

26-35 

not  used 

5-37 


3-(3*N+2) 


0-35 

SNUMB 

0-11 

Program  status 

12-17 

Program  # 

18-26 

Memory  needed 

27-28 

Not  used 

29-35 

Activity  # 

0-5 

Device  type  needed 

6 

0  =  fixed  device 

1  =  removable  device 

7-17 

#  of  devices  needed 

18-35 

Not  used 

The  following  occur  after  the  PALC  data  or  after  word  1 
if  there  is  no  PALC  data  (bits  24  or  25  set  to  0). 

This  information  is  variable  with  1  or  more  words  per 
program.  When  no  PALC  data  exists,  word  2  as  described 
above  does  not  pertain. 


One  word  of  data  for  any  activity  not  in  memory: 


0 

Flag  (=1  -  activity  is  terminating) 

1-8 

Activity  number  from  .CRSN1 

9-17 

Demand  in  512-word  blocks 

18-23 

Memory  allocator  urgency 

24 

Flag  (=1  -  job  is  waiting  memory) 

25 

Must  be  zero 

26 

Privity  indicator.  Assume  system  pro¬ 
gram  if  program  number  is  greater  than 
7,  activity  number  is  zero,  and  privity 
bit  is  set 

27 

Flag  (=1  -  if  new  job  or  new  activity) 
(copy  of  bit  29,  .CRLAL) 

28-29 

Must  be  zero 

30-35 

Program  number 

Multiple-word  entries  for  any  activity  in  memory 

where  the 

first  word  contains: 

0 

Flag  (=1  -  activity  is  terminating) 

1-8 

GEMORE  demand  in  512-word  blocks 

9-17 

Number  of  512-word  blocks  allocated 

18-23 

Number  of  SSA's 

24 

Must  be  zero 

25-27 

Job  status 

28-29 

Not  used 

30-35 

Program  number 

5-38 


1 


The  following  information  is  dependent  on  job  status 
(bits  25-27  of  word  1 ) 


Job  Status 


Infomation  Collected 


0  Mo  data  follows 

1  Mew  nenory  address 

2  Snumb  and  activity 

3  Snumb,  activity,  new  address 

4  10  ident  words,  2  userid  words 

5  Ident,  userid,  new  address 

6  Ident,  useri d, snumb,  activity 

7  Ident,  userid,  snumb,  activity,  address 


The  Memory  address  word  contains  the  following: 

0-17  MBA  in  512  word  blocks 
18-26  LAL  in  512  word  blocks 
27-35  Mot  used 


The  Activity  word  contains  the  following: 

0-8  Mot  used 

9-17  Activity  number 

18-35  Not  used 

All  multiple  word  entries  contain  the  following  three 
words: 


Current  CPU  time 
Current  I/O  Time 
Memory  Use  Word 


The  Memory  Use  Word  contains  the  following: 


0-17  Memory  used 

18-29  Termination  Code 

30-35  Mot  used 


At  the  end  of  all  T10 


records  the  following  two  words  will  appear: 


0-35  Number  of  512-word  blocks 

Available  (word  0,  .CRPMU  table) 
0-35  RSCR  Time 


If  a  RLSEC  request  is  delayed  (e.g.  a  request  to  release  memory  in 
which  TSS  is  loaded  must  wait  until  TSS  is  swapped),  then  the  number 
of  blocks  available  may  include  nonallocatable  memory  (that  portion  of 
the  RLSEC  beyond  the  size  of  TSS).  A  delayed  RLSEC  request  may  be 


•i 
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indicated  by  consecutive  MUM  records  which  show  no  changes  in 
memory ( the  MUM  writes  its  record  every  tine  that  .MP004  is  called;  in 
a  delayed  RLSEC  request,  .MP004  takes  its  denial  exit  without  changing 
tne  nenory  state) . 

5. 4. 2. 2  Trace  Type  46.  This  GCOS  system  trace  is  generated  every 
tine  a  job  is  given  a  program  nunber  and  results  in  a  trace  type  46 
MUM  record  being  generated.  The  format  of  the  GMC  trace  type  46 
record  is  shown  below. 


Word 

Bi  ts 

Infomati  on 

1 

0-17 

Size  of  record  (=3) 

18-26 

Not  used 

27-35 

Octal  46  (trace  number) 

2 

0-29 

smm 

30-35 

Octal  46 

3 

0-11 

Not  used 

12-17 

Program  number 

18-35 

Not  used 

4 

0-35 

Time  stamp 

5.4.3  MSM.  The  MSM  processes  GCOS  system  trace  types  7  and  15  by 
creating  its  own  data  collection  records  to  describe  the  effect  of 
these  events.  It  also  processes  the  specially-generated  GMC  trace 
events  73  and  76. 

5. 4. 3.1  Trace  Type  7.  This  GCOS  system  trace  is  generated  every  time 
a  connect  is  issued  and  will  result  in  the  generation  of  a  GMC  trace 
type  7  record.  The  format  of  the  GMC  trace  type  7  record  is  shown 
below. 


Word 

Bits 

Information 

1 

0-17 

Size  of  record  (normal  =  8,  special  =  21) 

18-23 

Special  file  code  description  flags 

18 

Permanent  (=0),  temporary  (=D 

19 

Random  (=0),  sequential  (=1) 

20 

Not  catalogued  (=0),  catalogued  (=1) 

21 

Removable  (=0),  fixed  (=1) 

22 

Flag  (=1  -  TSS  user  file  (no  file  code)) 

23 

Flag  (=1  -  SCF  File  I/O  (trace  22  is 
missing) ) 

24-26 

Processor  # 

27-35 

Octal  7  (trace  number) 

2 

0-17 

I/O's  word  count 

18-23 

Program  number 

24-35 

File  code 

3 

0-35 

System  controller  time  of  day 

5-4Q 


4 


5 

6 


7 


8 


9 


10 


11-20 
21  -22 


0-29 

30-35 

0-5 

5-35 

0-5 


6-17 

18-35 

0-13 

14 

15 

16-35 

0-5 

6-11 

12-17 

18-23 

24-26 

27-29 

30-35 

0-17 

18-35 


0-17 

18 

19-28 

29-34 

35 


CP  tine  usage 
IOM  connand 
Hot  used 
Sm.'MB 

Device  connand 
Special  note: 

A  connand  of  octal  72  to  a  pemanent  disk 
pack  indicates  that  a  pack  exchange  is  in 
progress.  The  . MCP66  nodule  issues 
another  standby  connand  to  the  device  to 
which  the  pemanent  pack  is  to  be  noved. 

A  special  device  nane  record  should  appear 
either  in  the  current  block  on  tape  or  at 
the  beginning  of  the  next  block  to  confirm 
the  pack  exchange. 

DCVl  length 

File  origin  block  number 

File  size 

Sysout  flag 

Seek  flag 

See!:  address 

Device  connand 

Device  number 

lOf!  PUP  number 

I/O  Command 

Mot  used 

I0H  number 

Record  count 

MBA  of  job  issuing  connect  or  zero  if 
no nex tended  memory 
I/O  queue  address  in  SSA  (absolute 
address  if  nonextended  memory  or  if 
value  less  than  64K ;  relative  address 
(to  MBA)  if  extended  memory  and  if  value 
greater  then  64K) 

Activity  number 

Flag  (=1  -  I/O  status  is  stopped) 

Mot  used 

I/O  status  (I/O  queue  word  0) 

Flag  (=1  -  system  job) 

IDEM! 

USERID 


5. 4. 3. 2  MSM  Special  Record.  During  the  execution  of  MSM  a  special 
record  is  written  at  preselected  times  during  the  monitoring  session. 
These  records  are  used  to  analyze  SSA  cache  core,  when  configured. 

The  format  of  this  record  is  shown  below.  This  record  is  based  on 
data  collected  during  the  processing  of  GMC  trace  events  73  or  76. 
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l/o  rd 


Bi  ts 


Information 


1  0-17 

18-26 
27-35 

2-516  0-35 


517  0-35 

518  0-35 


Si ze  of  record  ( =51 7  ) 

Mot  used 

Octal  7  (trace  number) 

a.  Number  of  times  each  GCOS  nodule  1-515 
was  in  the  SSA  cache  buffer 

b.  Number  of  times  each  GCOS  module  1-515 
was  loaded  by  an  I/O  because  it  was  not 

in  the  SSA  cache  buffer. 

Mot  used 

Flag  (=2  -  case  a.  above) 

( =3  -  case  b.  above) 


5. 4. 3. 3  Device  Name  Record.  If  either  MSM  or  CM  is  active,  the  GMC 
writes  a  record  which  correlates  device  names  to  device  addresses. 

The  System  Configuration  Mane  table  is  processed  sequentially  as  this 
record  is  formatted.  Names  for  all  disk  devices  are  reported.  In 
order  to  detect  exchanges  of  mass  storage  devices,  GMC  periodically 
examines  the  device  name  table.  If  any  changes  have  occurred,  then 
another  device  name  record  is  written.  This  record  is  variable  in 
size,  and  recognized  by  the  special  format  of  the  second  word. 


Word  Bits  Information 


1  0-17 
18-26 
27-35 

2  0-35 

3-n  0 


1-5 

6-11 

12-17 

18-35 


Size  of  record 
Mot  used 

Octal  7  (trace  number) 

Octal  535353535353 

Flag  (=1  -  fixed  device  if  mass  storage) 
(set  if  bits  13  and  14  of  the  second  word 
of  the  SCT  entry  for  any  mass  storage 
device  are  both  zero;  in  Shared  Mass 
Storage  environment,  shared  devices  must 
be  fixed) 

IOM  number 
Channel  number 
Device  number 
Device  name  in  BCD 


5. 4. 3. 4  FILSYS  Catalog  Structure  Record.  During  the  execution  of 
the  Mass  Store  Monitor,  certain  MME  GEFSYEs  GCOS  Trace  15  data  are 
collected  concerning  the  catalog  file  string  that  is  being 
referenced.  The  purpose  of  this  data  is  to  try  and  determine  how  many 
connects  are  being  made  because  of  the  particular  structure  of  a  given 
catalog  or  file.  This  data  is  also  used  to  provide  the  catalog  file 
string  name  associated  with  the  various  user  file  codes  that  are 
reported  by  the  Mass  Store  Monitor.  MhC  GEFSYE  traces  are  only 
processed  if  generated  by  a  system  program  (program  number  less  then 
15  or  FSTSLV).  In  addition,  only  the  following  GEFSYE 's  will  be 
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processed:  2,  3,  4,  5,  8,  9,  10,  11,  18,  19,  20,  22,  23,  27,  28,  and 
29.  The  format  of  the  GMC  record  generated  is  as  follows: 


Word 

Bits 

Information 

1 

0-17 

Size  of  record  (variable) 

18-26 

Not  used 

27-35 

Octal  15  (trace  number) 

2 

0-35 

-1  if  program  generating  this 
record  is  not  PALC.  Otherwise 

this  word  contains  a  file  code  in 
bits  18-35. 

3 

0-35 

-1  if  program  generating  this 
record  is  not  PALC.  Otherwise 

it  contains  the  SNUMB  of  the  job 
for  which  PALC  is  working. 

4 

0-17 

GEFSYE  type 

18-20 

Processor  # 

21  -26 

Program  # 

27-35 

Activity  # 

5-n 

0-35 

Catalog  file  string  name  -  not  to 
exceed  40  words. 

5. 4. 3. 5  FMS  Cache  Record.  During  the  execution  of  MSM  or  CM  a 
special  record  is  written  at  preselected  times  during  the  monitoring 
session.  These  records  are  used  to  analyze  FMS  catalog  cache,  when 
configured.  This  record  is  not  generated  on  a  WW6.4  system.  The 
format  of  this  GMC  record  is  shown  below. 


Word 

Bits 

Information 

1 

0-17 

Size  of  record  (=9) 

18-26 

Not  used 

27-35 

Octal  77  (special  flag) 

2 

0-35 

Number  of  cache  hits  (word  -12  from 
entry  point) 

3 

0-35 

Number  of  writes  (word  -11  from 
entry  point) 

4 

0-35 

Number  of  reads  (word-10  from 
entry  point) 

5 

0-35 

Number  of  reads  not  in  CC  (octal  1511 
from  entry  point) 

6 

0-35 

Number  of  non-320  word  reads  (octal  1512 
from  entry  point) 

7 

0-35 

Number  of  skips  caused  by  .SSTAK  (octal 
1513  from  entry  point) 

8 

0-35 

Number  of  cache  clears  (octal  1514  from 
entry  point) 

9 


0-35 


Number  of  no  hits  (octal  1520  from 
entry  point) 

10  0-35  Number  of  hits  (octal  1521  from  entry 

point) 

5.4.4  CPIIM.  The  CPU  Monitor  processes  the  GMC  generated  event  trace 
type  70. 

5. 4. 4.1  Trace  Type  70  -  Standard.  This  GMC  record  allows  six 
processors  to  be  monitored  and  allows  differentiation  between  TS1 
executive  processor  time  and  TS1  subdispatch  processor  tine.  If  an 
activity  has  a  program  number  greater  than  14  or  FSTSLV,  it  is 
considered  as  a  system  program  if:  it  is  privileged  (bit  18  of  the 
.STATE  is  set)  and  if  it  has  no  J*  file  for  SYSOUT  ( . SGNPA) .  This 
extension  of  the  definition  for  system  programs  allows  accumulation  of 
processor  time  used  primarily  by  copies  of  GEIN.  Although  DRL  TASK 
jobs  have  no  J*  file,  they  are  considered  user  activities  because 
they  are  not  privileged  (the  CPU  monitor  will  accumulate  processor 
time  associated  with  termination  of  DRL  TASK  jobs  as  system  CPU  time 
since,  when  terminating,  DRL  TASK  activities  are  privileged).  An 
activity  is  recognized  as  a  copy  of  TSS  if  bit  13  in  its  .STAT1  word 
is  set  and  if  its  SNIJMB  is  TS2,  TS3,  or  TS4  (TS1  always  has  program 
number  5).  The  check  on  the  .STAT1  word  eliminates  possible  confusion 
between  legitimate  copies  of  TSS  and  GEIN  execution  of  spawn  files  or 
termination  of  DRL  TASK  jobs  by  the  same  names.  If  a  system  program 
has  a  SNUMB  of  $PACT,  $M0LT,  $P0LT,  $C0LT,  $S0LT,  or  $SLTA  its 
processor  time  is  accumulated,  along  with  that  for  program  number  six 
(test  and  diagnostics).  If  a  system  program  described  above  performs 
an  initialization  before  it  puts  its  SNUMB  into  .CRSNB,  its  processor 
time  may  be  accumulated  in  the  special  category  for  miscellaneous 
system  programs.  The  format  for  this  GMC  trace  type  record  is  shown 
below. 


Word 

Bits 

Information 

1 

0-17 

Size  of  record  (77  or  83) 

18-26 

Not  used 

27-35 

Trace  number  (octal  70) 

2 

0-35 

Processor  time  for  system  programs  not 
otherwise  recognized  (e.g.  GEIN,  DRL 

TASK  termination) 

3 

0-35 

Time  for  program  1  ($CALC,  core  allocator) 

4 

0-35 

Time  for  program  2  ($PALC,  peripheral 
allocator) 

5 

0-35 

Time  for  program  3  ($SY0T,  SYSOUT  writer) 

6 

0-35 

Time  for  program  4  ($RTIN, 'scheduler) 

7 

0-35 

Time  for  program  5  (TS1,  TS  executives  #1 ) 

8 


0-35 


Time  for  program  6  ($T0LT,  TSD  executive; 
also  includes  time  for  special  T3D  SfJUMBs) 


9-16 

0-35 

Time  for  programs  7-14  (decimal) 
(transaction  processor,  log-on,  F I L SYS 
protection,  WIN,  DMTEX) 

17 

0-35 

Processor  time  for  GMC 

18 

0-35 

Processor  time  for  user  programs 

19 

0-35 

Subdispatch  tine  for  program  5  (TS1 ) 

20 

0-35 

Processor  time  for  TS2  executive 

21 

0-35 

Processor  time  for  TS3  executive 

22 

0-35 

Processor  time  for  TS4  executive 

23 

0-35 

Subdispatch  tine  for  TS2 

24 

0-35 

Subdispatch  time  for  TS3 

25 

0-35 

Subdispatch  time  for  TS4 

26 

0-35 

Miscellaneous  subdispatch  time 
(expansion  capability  for  TDS,  TPE  II) 

27-51 

0-35 

Counters  for  words  2-26 

52 

0-35 

RSCR  time 

53-58 

0-35 

Idle  time  for  processors  0-5 
(.CRIDT) 

59-64 

0-35 

Overhead  tine  for  processors  0-5 
(.CROVH) 

65 

0-35 

Humber  of  system  jobs  in  CPU  queue 

66 

0-35 

Humber  of  user  jobs  in  CPU  queue 

67 

0-17 

Number  of  system  jobs  having  negative 
number  of  nonremote  1/0  requests 
(logically  impossible  condition; 
number  of  such  1/0  requests  is  .SRQCT, 
-'its  0-1'  ni.nus  .SREMT,  bits  18-35) 

18-35 

Number  of  system  jobs  having  out¬ 
standing  1/0 

68 

0-35 

Same  as  word  66,  for  user  jobs 

69 

0-17 

Number  of  system  jobs  not  in  CPU  queue 
and  having  no  1/0  requests 

18-35 

Number  of  system  jobs  in  CPU  queue  v/i  th 
outstanding  1/0  requests  (overlapped  CPU 
and  1/0) 

70 

0-35 

Same  as  word  68,  for  user  jobs 

71 

0-35 

Number  of  busy  processors  (does  not 
recognize  the  interrupt  handler) 

72 

0-35 

Counter  for  determining  when  to  write 
record 

73 

0-35 

CPU  time  for  special  SNUMB  1 

74 

0-35 

CPU  time  for  special  SNUMB  2 

75 

0-35 

CPU  time  for  special  SNUMB  3 

76 

0-35 

Special  SNUMB  1  (BCD) 

77 

0-35 

Special  SNUMB  2 

78 

0-35 

Special  SNUMB  3 
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5. 4. 4. 2  Trace  Type  70  -  Extended.  This  GMC  trace  record  is  identical 
to  the  standard  type  70  record  described  in  subsection  5. 4. 4.1  except 
for  six  additional  words.  These  words  are  included  only  when  the 
special  gate  loop  code  is  present  in  the  .MFALT  module  (should  always 
be  present  in  mul ti processor  systems;  should  not  be  present  in  a 
uniprocessor  system).  This  format  is  shown  below.  This  record  is  not 
generated  on  a  WW6.4  system. 

Word  Bi ts  Information 

79-84  0-35  Gate  loop  time  for  processors  0-5,  obtained 

from  .if ALT  module  (Note:  .  fFALT  deducts 
gate  loop  time  from  processor  time  charged 
to  jobs  and  adds  it  to  overhead  time 
reported  in  .CROVH. ) 

5.4.5  TH.  The  Tape  Monitor  processes  three  GCOS  system  traces:  50, 
51,  and  52  and  creates  its  own  data  collection  records  to  evaluate  the 
effect  of  these  events. 

5. 4. 5.1  Trace  Type  50.  This  GCOS  system  trace  is  generated  whenever 
an  activity  goes  to  the  core  allocator  and  will  result  in  the 
generation  of  a  GMC  trace  type  50  record.  The  format  for  this  GMC 
trace  type  record  is  shown  below. 


Word 

Bits 

Information 

1 

0-17 

Size  of  record  (variable) 

18-26 

Not  used 

27-35 

Octal  50  (trace  number) 

2 

0-29 

SNUMB 

30-35 

Not  used 

3 

0-35 

Time  stamp 

4 

0-11 

Activity  number 

12-17 

Program  number 

18-29 

Urgency 

30-35 

Octal  50 

5-N 

0-35 

Words  1  and  2  of  SCT  entry  for  each  tape 
used  by  this  program 

5. 4. 5. 2  Special  Trace  Type  50.  The  first  GMC  trace  type  50  record  is 
a  special  trace  50  to  indicate  the  status  of  all  tape  drives  when  the 
monitor  first  begins.  Its  structure  is  shown  below. 


Word 

Bits 

Information 

1 

0-17 

Size  of  record  (variable) 

18-26 

Not  used 

27-35 

Octal  50  (trace  number) 

o 

0-35 

Not  used 

3 

0-35 

Time  stamp 

4 

0-35 

Flag  (-2) 

5 

0-35 

SNUMB 

6 

0-35 

Word  0  of  SCT  table 

7 

0-35 

.CRSN1  for  SNUMB 

8 

0-35 

Word  3  of  SCT  table 

9-N 

0-35 

Repeat  of  words  5-8  for  as  many  tape  drives 
as  are  currently  configured 

5.4. 5.3 

Trace 

Type  51 . 

This  GCOS  system  trace  is  generated  every 

time  an  activity  terminates  and  will  result  in  the  generation  of  a  GMC 

trace  type  51 

record.  This  record  structure  is  identical  to  the  type 

50  record 

structure  except  for  word  4.  The  format  for  this  word  is 

shown  below. 

Word 

Bi  ts 

Information 

4 

0-11 

Abort  code 

12-17 

Program  number 

18-26 

Urgency 

27-29 

Type  of  abort 

30-35 

Octal  51 

5. 4. 5. 4 

Trace  Type  52. 

This  GCOS  system  trace  is  generated  every 

tine  a  program 

is  denied 

a  tape  due  to  unavailability  and  will  result 

in  the  generation  of  a  GMC  trace  type  52  record.  The  format  for  this 

GMC  trace 

type  52  record 

is  shown  below. 

Word 

Bits 

Information 

1 

0-17 

Record  size  (variable) 

18-26 

Not  used 

27-35 

Octal  52  (trace  number) 

2 

0-35 

Not  used 

3 

0-35 

Time  stamp 

4 

0-35 

Flag  (-2) 

5 

0-35 

Register  A  of  standard  type  52  trace 

6 

0-35 

Register  Q  of  standard  type  trace 

7-N 

0-35 

Same  as  special  trace  50,  words  5-n 

5.4.6  CM^  The  Channel  Monitor  processes  four  different  GCOS  system 
trace  types:  4,  7  and  22.  These  events  cause  the  generation  of  the 
following  GMC  trace  records. 

5. 4. 6.1  Trace  Type  4.  This  GCOS  system  trace  Is  generated  at  the 
termination  of  an  I/O  and  will  cause  the  generation  of  a  trace  type  4 
GMC  record.  The  format  of  the  GMC  trace  type  4  record  is  shown  below. 
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'.lord 

Sits 

Infomation 

i 

0-17 

Sice  of  record  (=3) 

18-26 

Mot  used 

27-35 

Octal  4  (Trace  nunher) 

0-35 

Tine  stanp 

3 

0-2D 

A-regi ster  of  trace 

30-35 

IOM  nunher 

A 

0-17 

MBA  of  job 

18-35 

I/O  queue  address 

5. 4. 6. 2  Trace 

Type  7.  This  GMC  trace  record  is  the  sane  as  the  MSM 

trace  t''pe  7  record  described  in  subsection  5. 4. 4.1  and  5. 4. 4. 3.  Only 

one  trace  type 

7  is  generated  if  both  the  CM  and  MSM  are  active. 

5.4. 6.3  Trace  Type  22. 

This  GCOS  system  trace  is  generated  every 

tine  an  I/O  is 

requested  and  will  result  in  the  generation  of  a  GMC 

trace  type  22 
shown  below. 

record.  The 

format  of  this  GMC  trace  type  22  record  is 

Word 

Bi  ts 

Infomation 

1 

0-17 

Size  of  record  (=3) 

18 

Device  busy  flag  (set  if  device  is  busy) 

19 

Abort  flag  (set  if  bit  5  or  bit  6  in 
.STATE  is  set) 

20 

Swap/nove  flag  (set  if  bit  7  or  bit  8  in 
.STATE  is  set) 

21 

Flag  (=1  -  I/O  status  is  stopped) 

22-26 

I/O  status  (bits  31-35  of  I/O  queue  word  0) 

27-35 

Octal  22  (trace  number) 

2 

0-35 

Tine  stanp 

3 

0-35 

Device  type 

6-11 

Device  number 

12-17 

Channel  number 

18-23 

Program  number 

24-33 

Logical  primary  channel  index 

34-35 

IOM  number 

4 

0-17 

MBA  of  job 

18-35 

I/O  queue  address 

5.4.7  CAM.  The  Connuni cations  Analysis  Monitor  processes  the  GMC 
generated  event  trace  type  14. 

5. 4. 7.1  Trace  Type  14.  This  GMC  trace  is  generated  whenever  the 
H6000-355  mailbox  in  bNWW/MDNET  is  changed  and  will  result  in  the 
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writing  of  a  GMC  trace  type  14  record.  The  format  for  this  GMC  trace 
type  14  record  is  shown  below. 


Word  Bits  Information 

1  0-17  Record  size  (variable) 

18-26  Not  used 

27-35  Octal  14  (trace  number) 

2  0-35  Time  stamp 

3  0-2  355  number 

3-17  Logical  line  number 

18-35  Terminal  ID 

4  0-8  Terminal  type 

9-17  ICM  count 

18-26  OP  code 

27-35  Command 

5-7  0-23  ICM  Data 

8  0-23  Not  used 

24-35  Data  tally 

9  0-11  Ignore 

12-17  Status 

18-29  Input  data  tally 

30-35  Not  used 

10  0-17  Slave  LAL 

18-35  Checksum 

11-529  0-35  Cormunications  traffic  (only  if  specific 

CAM  option  specified) 

5. 4. 7. 2  Special  Trace  Type  14.  This  trace  record  is  written  during 
CAM  initialization  to  specify  the  start  time.  Its  structure  is  shown 
below. 

Word  Bits  Information 

1  0-35  Octal  7000014 

2  0-35  Time  from  MME  GETIME 

3-8  0-35  Not  used 

5.4.8  GRTM.  The  GRTS  Monitor  processes  one  GMC  trace  record,  type  62. 

5. 4. 8.1  Trace  Type  62.  This  GMC  trace  is  generated  whenever  the 
DATANET-355  GRTS  k)ni tor  data  record  is  transmitted  to  the  GMC.  The 
format  for  this  GMC  trace  type  62  record  is  shown  below. 


Word 

Bits 

Information 

1 

0-17 

Record  size  (variable) 

18-20 

DATANET  number 

21  -26 

Not  used 

27-35 

Octal  62  (trace  number) 
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Word 


Bi  ts 


Infomati  on 


2 

0-35 

Tine  stanp  -  R6000 

3 

0-17 

OAC  character  count 

18-35 

Tine  stanp  -  DN-355 

4 

0-17 

010101 

18-35 

Buffer  denials  (emulative) 

5 

0-17 

010201 

18-35 

Buffer  availabil i ty  (current) 

6 

0-17 

010301 

18-35 

Munber  of  users  (current) 

7 

0-17 

010401 

18-35 

Munber  of  transactions  sent  to  host 
(cumul ati ve ) 

8 

0-17 

010501 

18-35 

Munber  of  transactions  received  fron  host 
(cumul ati ve) 

9 

0-17 

010601 

18-35 

Munber  of  36-bit  words  sent  to  host 
(cumulative) 

10 

0-17 

010701 

18-35 

Munber  of  36-bit  words  received  fron  the 
host  (cumulative) 

11 

0-17 

011001 

18-35 

Munber  of  host  RSVPs  received  (cumulative) 

12 

0-17 

011101 

18-35 

Amount  of  tine  in  milliseconds  spent  in 
idle  loop  since  the  last  buffer  was  sent 

13 

0-17 

011201 

18-35 

Munber  of  calls  to  the  buffer  allocation 
routine  (cumulative) 

14 

0-17 

030105 

18-26 

HSLA 

27-35 

HSLA  subchannel 

15 

0-17 

Munber  of  transmits  on  S/C  (cumulative) 

18-35 

Number  of  receives  on  S/C  (cumulative 

16-N 

Additional  entries  depending  on  the  number 
of  subchannels  specified  on  the  data  card. 

N+l 

Response  Tine  Buffer.  This  portion  of  data 
is  variable  depending  upon  the  activity 
occurring  on  the  DN-355.  The  various  types 
of  data  that  can  be  collected  in  this 
buffer  are  illustrated  below. 
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Every  line  displayed  require  13  bits  of  buffer  space. 


000010000001000010 

Terminal  Type  /  Line  ID 

Time  Stamp 

Direct  Access  Name  (1/2) 

Connect-To-Sl ave  Record 

000010000010000010 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Send  Output  Record 

000010000011000010 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Accept  Direct  Output  Record 

00001 00001 0000001 0 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Accept  Direct  Output  and  Then 
Input  Record 

000010000101000010 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Accept  Direct  Input  Record 

000010000110000010 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Input  Accepted  Record 

000070000177000070 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Disconnect  Record 

000010001000000010 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Output  Received  Record 

00001 0001001000010 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Output  Started  Record 

00001 0001 01 000001 0 
Terminal  Type  /  Line 
Time  Stamp 

ID 

Output  Complete  Record 

ooooi  oooi  on  ooooio 

Lost  Message  Count 

Lost  Message  Record  (Always  first 
data  in  type  2) 
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The  following  definitions  apply  to  the  above  record  types. 

0  Connect-To-SI ave  A  terminal  has  logged  on  to  an  H6000  DAC 
program. 

0  Send  Output  DATANET-355  requesting  more  output  from  the  H6000. 

0  Accept  Direct  Output  The  H6GQO  has  told  the  DATANET-355  that 

T t  has  data  to  send. 

0  AcceptDirect  Output  and  Then  Input  The  H6000  has  told  the 
DATANET-355  that  it  has  data  to  send  and  expects  input  to  be 
returned. 

0  Accept  Direct  Input  The  DATANET-355  asking  the  H6000  to  accept 
data. 

0  Input  Accepted  Input  received  by  the  H6000. 

0  Pi sconnect  A  terminal  has  disconnected  from  a  H6000  DAC 
program. 

0  Output  Received  DATANET-355  has  received  data  from  the  H6000. 

0  Output  Started  DATANET-355  has  started  to  transmit  data  to  a 
terminal’. 

0  Output  Complete  DATANET-355  has  finished  sending  data  to  the 
terminal. 

5.4.9  IDLEM.  The  Idle  Monitor  processes  a  GCOS  system  trace  type  21 
by  creating  its  own  data  collection  record  to  describe  the  effect  of 
this  event. 

5. 4. 9.1  Trace  Type  21.  The  format  of  the  GMC  trace  type  21  record  is 
shown  below.  The  data  in  this  record  is  obtained  from  the  occurrence 


of  many 

different  system 

trace  events  (see  table  5-1). 

Word 

Bits 

Information 

1 

0-17 

Size  of  record  (=3) 

18-20 

Processor  number 

21  -26 

Not  used 

27-35 

Octal  21  (trace  number) 

2 

0-35 

Time  idle  was  broken 

3 

0-35 

Time  idle  started 

4 

0-35 

Not  used 

5-52 


5.4.10  TPS.  The  TPSfl  processes  GCOS  system  trace  types  0,  1,  2,  4, 
5,  5,  13,  42,  51,  65  and  74  by  creating  its  own  data  collection 
records  to  describe  the  effect  of  these  system  events. 


5.4.10.1 

Trace  Types  0,  1 

,  2,  4,  5,  6  and  65.  These  GC0S  system 

traces  are  generated  during  job  I/O  and  execution  and  result  in  the 

generation  of  a  GMC  trace 

type  74  record.  The  format  for  this  GMC 

trace  type  record  is  shown 

bel ow. 

'.lord 

Bi  ts 

Information 

1 

0-17 

Number  of  words  following  (record  control 

word) 

18-26 

Not  used 

27-35 

Octal  74  (trace  number) 

2 

0-35 

Register  A  of  standard  GC0S  trace 

3 

0-35 

Register  Q  of  standard  GCOS  trace 

4 

0-35 

Time  Stamp 

5.4.10.2 

Trace  Types  13, 

42  and  51 .  These  GCOS  system  traces  are 

generated 

for  each  job  start,  process,  and  termination.  The  TPSM 

processes 

these  traces  for 

each  TPAP  and  generates  the  following  GMC 

trace  type  74. 

Word 

Bi  ts 

Information 

1 

0-17 

Number  of  words  following  (record  control 

word) 

18-26 

Not  used 

27-35 

Octal  74  (trace  number) 

2 

0-35 

Register  A  of  standard  GCOS  trace 

3 

0-35 

TPAP  SNUMB 

4 

0-35 

Time  Stamp 

5.4.10.3  Trace  Type  74.  This  internally  generated  TPE  trace  has  a 
variable  format  depending  upon  where  within  TPE  the  trace  was 
generated. 

5.4.11  Special  Records.  During  the  execution  of  the  GMC,  it 
sometimes  is  necessary  to  generate  special  records  that  describe  the 
occurrence  of  a  special  event.  Following  is  a  description  of  these 
special  records. 

5.4.11.1  Lost  Data  Record.  If  the  rate  of  data  collection  does  not 
allow  GMC  to  dump  its  i nternal  buffers  to  tape  or  if  the  system 
develops  a  tape  malfunction,  it  is  possible  for  GMC  to  generate  a  lost 
data  condition.  When  this  condition  occurs,  a  special  trace  is 


5-53 


generated  in  the  last  good  record  recorded  on  tape.  The  next  good 
trace  recorded  will  be  found  at  the  beginning  of  the  next  physical 
record. 

Word  Bi ts  Information 
1  0-35  000777200100 


5.4.11.2  Termination  Record 
special  termination  record. 


5.6.1. 


Upon  termination,  GMC  writes  out  a 
The  format  is  described  in  subsection 


5.4.11.3  End-of-Reel  Flag.  When  the  multireel  option  is  enabled,  GMC 
writes  the  following  special  record  header  at  the  end  of  each  tape. 


Word 


Bits  Information 


1 

2 


0-35  007773400100 

0-35  Continuation  reel  number  (BCD) 


5.4.11.4  MUM  Lost  Data.  If  GMC  generates  a  lost  data  condition  while 
executing  the  flUM,  the  MUM  generates  a  special  flag  in  the  header. 

The  format  of  this  flag  is  described  below. 


Word 

Bi  ts 

Information 

1 

0-17 

Record  size 

18-35 

Octal  200110  (lost  data  flag) 

5.4.11.5  Reconfiguraton  Record.  The  format  of  this  record  is 
described  in  subsection  6.4.1  under  the  reconfiguration  discussion. 

5.5  GMF  User  Input  Parameter  Options 


The  user  must  start  here  to  define  his  intended  use  of  the  GMC  so 
that  he  can  then  determine  his  JCl  and  system  structure. 

User  control  over  GMC  is  total  as  a  complete  parameter  capability 
is  provided.  A  sample  data  parameter  card  is  shown  in  figure  5-3. 

The  G«MC  functional  options  are: 

(1)  Capability  to  turn  off  any  particular  monitor  or  combination 
of  monitors. 

(2)  Specifying  that  collection  is  to  halt  after  filling  1-9  data 
tapes.  The  default  is  to  collect  an  unlimited  number  of 
tapes. 


5-54 


cc 


MO  M3  Turn  off  Monitor  0  and  3 

Ml  Turn  off  Monitor  1 

Ml  M9  Turn  off  Monitor  1  and  collect  only  a  single 

reel 

Ml  *12.36,05.00  Turn  off  Monitor  1,  start  collecting  data  at 

12.36,  and  collect  for  5  hours 

*,03.00  All  Monitors  are  present  on  the  R*  file  and  are 

active,  collection  is  to  start  at  once  and 
continue  for  3  hours 

+CK  All  Monitors  are  present  on  the  R*  file,  and 

conmuni cation  traffic  is  to  be  monitored  for 
terminal  CK 

Ml  M4  M93  Turn  off  Monitors  1  and  4,  and  collect  maximum 

of  three  reel s  of  data 

M*  Suppress  abort  if  GMC  cannot  move 

#VIDE0, HEALS  All  Monitors  are  present  on  the  R*  file,  and 

accumulate  processor  time  in  the  CPU  Monitor 
for  these  SNUMBS. 

M0  M5  M8  ?1  Turn  off  monitors  0,  5,  and  8.  Collect 

only  tape  connects  with  the  MSM  and  CM. 


Figure  5-3..  Data  Card  Examples 
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(3)  Requesting  complete  cormuni cation  data  for  1  or  2  terminal 
IDs. 

(4)  Suppressing  a  GMC  abort  if  it  cannot  move  to  an  acceptable 
location. 

(5)  Specifying  up  to  three  SNUMBS  to  be  processed  by  the  CPU 
Moni  tor. 

(6)  Requesting  that  only  tape  connects  or  mass  storage  connects 
be  collected,  but  not  both.  The  default  is  to  collect  both 
types. 

(7)  Declaring  the  start  and  stop  times  of  monitoring. 

(8)  Requesting  high  density  tape  be  collected. 

(9)  Specifying  the  monitoring  requirements  for  the  GRTM. 

5.5.1  On/Off  Option.  This  option  allows  the  user  to  turn  off  all 
monitors  not  required  for  his  purposes.  The  GMC  default  is  to  have 
all  monitors  on.  The  code  format  to  turn  off  a  given  monitor  is: 

MO  =  Memory  Utilization 
Ml  =  Mass  Store  Monitor 
M2  =  CPU  Monitor 
M3  *  Tape  Monitor 
M4  =  Channel  Monitor 
M5  =  Communications  Monitor 
M6  =  GRTS  Monitor 
M7  =  TPS  Monitor 
M8  =  Idle  Monitor 
MA-MF  =  User  Developed  Monitors 
(See  Section  13  for  a  discussion  of  user  developed  monitors.) 

While  it  is  optional  to  turn  off  a  monitor,  a  user  must  turn  off,  on 
the  parameter  card,  any  monitor  that  is  not  loaded  in  the  compiled 
R*.  Failure  to  do  so  will  result  in  an  M0-M8  abort.  The  digit 
following  the  M  represents  the  monitor  that  is  not  present  on  the  R* 
file,  but  yet  was  not  turned  off  on  the  parameter  card.  Details  for 
creation  of  the  R*  file  are  given  in  subsection  5.6. 

5.5.2  Tape  Selection  Option.  This  option  allows  the  user  to  specify 
the  number  of  data  collector  tapes  to  be  accumulated  in  a  job  run. 

M9  *  One  reel  of  tape 

M91  *  One  reel  of  tape 

M92  *  Two  reels  of  tape 

M93(4-9)  *  Specified  number  of  reels 
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When  this  option  is  used,  GMC  will  terminate  with  an  SF  abort. 

5.5.3  Terminal  Specification  Option.  This  option  allows  the  user  to 
specify  the  one  or  two  terminal  ID's  for  which  it  is  desired  to 
collect  total  terminal  data.  This  option  may  only  be  selected  if  the 
CAM  is  active  and  causes  all  data  seen  by  the  H6000  for  the  selected 
terminal  to  be  written  to  the  GMC  tape. 

+ID  =  Collect  data  for  a  single 

terminal  (replace  ID  with  the 
actual  terminal  ID) 

+ID,ID  =  Collect  data  for  two  terminals 

CAUTION:  This  option  can  possibly  collect  passwords  and  therefore  the 
data  tape  will  be  classified  to  the  highest  level  on  the  system. 
Without  this  option  all  tapes  are  unclassified. 

5.5.4  Move  Option.  This  option  allows  the  user  to  suppress  an  abort 
if  GMC  cannot  relocate  out  of  the  growth  range  of  TSS.  See  subsection 
5.3  for  an  explanation  of  the  GMC  relocation  procedure.  The  proper 
code  for  this  option  is  shown  below. 

H*  =  suppress  abort 

5.5.5  CPU  SNUM8  Option.  This  option  allows  the  user  to  specify 
SNUMBS  for  the  CPU  Monitor  special  option.  The  CPU  Monitor  will 
separately  accumulate  processor  times  in  its  data  records  for  up  to 
three  SNUMBS. 


#SMUMB1  =  Accumulate  processor  time  for 
a  single  job  (replace  SNUMB1 
with  actual  SNUMB  of  a  job) 

#SNUMB1 .SNUMB2  =  Accumulate  processor 
time  for  two  jobs 

#SNUMB1 .SNUMBZ.SNUMBS  =  Accumulate  processor 

time  for  three  jobs 

5.5.6  Connect  Option.  This  option  allows  the  user  to  suppress 
collection  of  tape  connects  or  mass  store  connects  within  the  CM  or 
MSM. 


?1  3  Only  tape  connects  wanted 
?2  =  Only  mass  store  connects  wanted 

The  default  for  this  option  is  that  all  tape  and  mass  storage  connects 
are  collected. 
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5.5.7  Tine  Option.  This  option  allows  the  user  to  specify  run  tine 
parameters.  The  time  capability  is  to  pre-set  a  tine  to  begin  data 
collection  with  a  tine  length  to  run  after  collection  starts. 

*07.00,04.00  =  start  at  7:00  a.m.,  run  for  four 
hours  and  stop  at  11:00  a.n. 

*16.00  =  start  at  4:00  p.m.,  no  stop  specified 
*,02.50  =  start  immediately,  stop  after  2  1/2  hours 

Rules  for  this  option  are: 

a.  The  time  option  must  be  the  last  parameter  on  the  data 
parameter  card  as  the  card  is  read  left  to  right  and  tine  is 
the  last  entry  processed. 

b.  Asterisk  signals  GMC  to  process  the  time  input  option. 

c.  Use  four  characters  for  all  tines  in  each  tine  entry  field. 

Time  is  expressed  as  a  24-hour  clock.  All  zero's  must  be 
present  on  the  parameter  card. 

d.  If  the  tine  option  specifies  a  start  at  0900  for  a  4  hour  run 
to  1300,  and  GMC  is  not  spawned  until  1000,  the  run  will  still 
terminate  at  1300.  In  this  case,  only  3  hours  of  data  will  be 
collected,  even  though  4  hours  of  collection  was  specified. 

e.  The  user  can  request  the  following:  *22.00,  04.00.  This  means 
data  collection  should  begin  at  22:00  and  continue  until 
02:00.  The  GilC  will  handle  the  problem  of  a  clock  rollover. 

f.  GMC  allocates  a  tape  drive  as  soon  as  it  initially  goes  into 
execution.  It  keeps  this  tape  drive  even  when  it  goes  to  sleep 
until  told  to  start  up.  Therefore,  if  GMC  is  spawned  at  0700 
and  told  to  collect  data  starting  at  1100,  the  tape  drive  will 
be  allocated  from  0700. 

g.  If  no  time  option  is  used,  the  GMC  will  start  collecting  data 

upon  entry  into  the  system  and  terminate  upon  a  console  request 

or  tape  limit  request.  When  a  time  option  is  used,  the  GMC 

will  terminate  with  a  TS  abort. 

5.5.8  Specifying  High  Density  Tape.  On  tape  output,  the  GMC  will 

write  for  1 1 50  records,  or  to  the  end  of  tape  mark.  If  a  user  desires 

to  alter  this  procedure  so  that  a  high  density  write  (1600  8PI  2100 

records)  can  be  performed,  the  following  option  should  appear  on  the 
data  card:  M;.  This  option  may  appear  anywhere  on  the  data  card,  but 
must  preceed  the  time  option  request.  The  user  will  also  need  to 
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modify  the  $TAPE  card  in  the  GMC  execution  JCL  so  as  to  specify  1600 
BPI  tape  collection  (see  subsection  5.7). 

5.5.9  Specifying  Monitoring  Requirements  for  the  GRTM.  In  order  to 
collect  GRTM  data,  an  M6  must  not  appear  on  the  first  data  card.  If 
the  M6  is  omitted  from  the  first  card,  then  the  GRTM  is  active,  in 
which  case  additional  data  cards  are  required.  The  additional  data 
cards  are  free  format  and  indicate  the  datanets  to  be  monitored,  the 
HSLA  subchannels  to  be  monitored,  and  finally  whether  response  time 
monitoring  is  to  be  performed.  By  default,  only  CPU  resource 
monitoring  will  be  conducted.  As  stated  earlier,  if  the  entire 
monitoring  function  is  to  be  selected,  the  GRTS  monitor  will  require 
approximately  2K  of  DATANET  memory.  On  the  other  hand,  if  only  the 
default  option  is  selected,  the  monitor  will  require  only  IK  of 
DATANET  memory.  The  required  parameter  categories  are  as  follows: 

Dn  =  FEP  number  (n=0  to  7) 

HSLAn  =  High  Speed  Line  Adapter  (HSLA)  number 
(n=l  to  3  per  FEP) 

SCHn  =  Subchannel  numbers  associated  with  each  HSLA  entry 
(n=l  to  32) 

Rn  =  Performance  response  time  monitoring  on  FEP  number 
(n=0  to  7) 

Semicolons  delimit  each  of  the  categories.  They  also  indicate  that 
more  GRTS  data  follows.  However,  the  last  data  card  should  not  have 
semicolon  at  the  end.  Commas  delimit  subchannel  sets.  A 
specifies  a  range  of  values  for  subchannels. 

Example: 

D1 ;HSLAl;SCH0-10,14,18-3O;HSLA2;SCH3-15,2O-3O;DO;RO 

In  this  example,  we  will  monitor  DATANET  #1  for  CPU  resources  (by 
default),  for  subchannel  usage  on  HSLA  1  subchannels  0-10,  14,  18-30, 
and  HSLA2  subchannels  3-15  and  20-30.  No  response  time  monitoring 
will  be  performed.  For  DATANET  0,  we  will  monitor  CPU  resources  (by 
default),  no  subchannels  will  be  monitored  but  response  time  will  be 
monitored.  In  order  to  determine  the  total  memory  used  by  the 
monitor,  the  following  formula  should  be  used: 

Memory  Used  =  IK  (default  for  CPU  resource  monitoring) 

+  32  words  *  (number  of  HSLAs) 

+  8  words  *  (number  of  subchannels  requested)  + 

IK  (if  response  monitoring  selected) 
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5.5.10  General  Rules  of  the  GMC  Data  Parameter  Card.  The  following 
are  general  rules  to  be  followed  in  defining  the  data  card: 


a.  The  tine  option,  if  selected,  nust  be  the  last  option  on  the 
data  card. 


.  b.  All  input  elements  of  the  eight  options  should  be  separated  by 
a  blank  character. 


5. 6  JCL  for  Creation  of  an  Object  File 

5.6.1  Introduction  to  JCL.  After  the  user  has  completed  a  study  of 
the  options  to  be  specified  in  the  parameter  cards  described  in 
subsection  5.5  above,  the  user  then  must  build  the  JCL  that  will 
create  the  user  version  of  a  GMC  object  file. 


The  user  has  optional  control  over  the  creation  of  a  GMC  object  file 
that  will  serve  his  purposes  based  on  functions  specified  on  the 
parameter  cards.  This  optional  structure  minimizes  the  size  of  the 
GMC  monitor  as  only  necessary  code  is  used  and  provides,  in  addition, 
for  easier  extension  to  the  capabilities  of  GMC. 

The  four  functions  to  be  built  are  initialization,  system  patch, 
remove  the  patch,  and  primary  monitor  collection  subroutines. 

5.6.2  Creation  of  an  Object  File.  The  GMC  executive  routine  has  been 
subdivided  into  discrete  sections  of  code  based  on  function.  In  order 
to  generate  a  usable  GMC  object  file,  the  individual  sections  of  code 
must  be  merged  to  create  a  single  routine.  This  procedure  has  been 
utilized  for  two  reasons.  First,  this  structure  permits  the  easy 
addition  of  new  programs,  i.e.,  monitors.  Secondly,  this  structure 
allows  the  simple  generation  of  a  GMC  containing  only  that  code 
required  to  capture  the  necessary  data.  If  a  user  wants  to  create  a 
GMC  containing  only  the  code  necessary  for  the  Memory  Utilization 
Monitor  and  Mass  Store  Monitor,  he  can  easily  do  so.  If  the  user  then 
decides  he  does  not  want  to  run  the  Mass  Store  Monitor,  he  can  either 
recreate  a  GMC  object  file  or  he  can  turn  off  the  Mass  Store  Monitor 
via  a  data  card.  Although  this  procedure  sounds  complicated,  it 
minimizes  the  size  of  the  GMC. 


When  GMF  is  restored  to  the  user's  system,  the  GMC  data  collector 
program  is  in  the  form  of  a  catalog  structure.  This  structure  is 
shown  in  figure  5-2.  The  GMC  catalog  structure  as  it  relates  to  the 
creation  of  GMC  R*  file  is  shown  in  figure  5-4.  For  a  description  of 
each  file  function,  refer  to  table  5-3. 

As  illustrated  in  figure  5-1,  the  GMC  consists  of  an  Executive  Routine 
which  initializes  all  the  required  programs,  installs  any  required 
system  patches,  records  the  system  patches,  and  removes  all  patches 
from  the  system  when  it  is  finished.  Table  5-3  gives  a  breakdown  of 
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: SELECTA: B29I0PX0/GWC0L/ ( see  below  for  FILE  requirements  and  options) 


all  required  GMC  files  and  any  optional  files.  The  user  selects  the 
programs  he  wants  to  monitor  in  the  system,  assembles  those  programs 
in  numerical  order,  and  runs  a  file-edit  job  to  create  a  GMC  object 
file.  Figure  5-5  is  an  example  of  a  GMC  containing  the  Memory 
Utilization,  Idle,  and  CPU  Monitors.  Figure  5-6  is  an  exanple  of  a 
GMC  containing  the  Mass  Store  Monitor,  Channel  Monitor,  and  Idle 
Monitor.  A  $  GMAP  card  is  required  before  the  SELECTA  for  /GMF.TOP, 
and  before  every  SELECTA  after  /GMF.BTM.  Under  normal  operating 
conditions,  the  FILEDIT  activity  will  contain  multiple  "Inconsistent 
Deck  Name"  error  messages,  which  can  be  ignored.  If  a  user  should 
improperly  create  an  R*  file  by  omitting  a  required  file,  the  GMC 
execution  will  abort  with  an  S1-S9  abort,  or  an  SA,  SC,  or  SD  abort, 
depending  upon  which  routine  is  missing.  The  user  should  refer  to 
table  5-2  for  an  explanation  of  these  aborts. 

The  GMF  is  designed  to  be  run  on  a  HIS  6000  computer  system,  running 
with  VMMCCS  GCOS  release  6.4  or  7.2.  These  releases  are  equivalent  to 
the  HIS  commercial  2H  or  4JS1  GCOS  releases. 

When  GMF  is  used  on  UWMCCS  release  7.2,  or  commercial  release 
4JS1-4JS3,  the  user  must  insure  that  the  value  for  variable  “SYS64"  is 
set  to  0.  This  variable  is  defined  in  an  ‘'EQU"  statement  located  in 
the  following  files:  B29IDPX0/GMFC0L/GMF/GMF. TOP, 
B29I0PX0/GMFC0L/CM/CM. T07A,  B29IDPX0/GMFC0L/CPU/CPU. T70  and 
B29IDPX0/GMF COL/MUM /MUM. T1 0.  See  subsection  2.6.2  for  a  discussion  of 
other  GMC  modifications  that  are  required  under  different  GCOS 
software  releases. 


Having  created  a  GMF  object  file,  no  other  system  modifications  are 
required  unless  the  GRT  Monitor  or  the  TPS  Monitor  is  desired.  Both 
of  these  monitors  require  system  modifications  to  be  made  prior  to 
their  use.  The  system  modifications  required  by  the  GRTS  Monitor  are 
described  in  subsection  5.2.7  of  this  chapter.  The  system 
modifications  required  by  the  TPS  Monitor  are  described  in  subsection 
5.2.9  of  this  chapter. 


5. 7  JCL  for  Executi ng  the  GMC 


The  JCL  needed  to  execute  the  GMC  is  shown  in  figure  5-7.  The  size  to 
be  placed  on  the  $  LIMITS  card  depends  on  the  number  of  monitors 
present  in  the  R*  file.  The  size  should  range  from  15K  to  24K, 
depending  on  the  number  of  monitors.  The  load  map  produced  on  the 
compilation  listing  from  the  General  Loader  will  specify  the  actual 
memory  size  required  to  load  GMC.  In  figure  5-7,  parameter  card 
following  $  DATA  I*  demonstrates  a  turn-off  for  the  MUM,  CPUM,  TM, 
GRTM,  IDLE,  TPSM  monitors,  and  a  collection  of  an  unlimited  number  of 
tapes.  If  the  GRTS  monitor  is  active,  it  me*y  dynamically  grow  GMC 
during  its  Initialization  procedure.  Because  of  this  feature,  the 
GRTS  monitor  requires  a  $  LIMITS  card  with  a  large  SYS0UT  request  to 
force  the  system  to  obtain  an  extra  IK  memory.  Figure  5-8  shows  the 
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SELECTA 

EXECUTE 

ENDEDIT 

ENDCOPY 


SOURCE, OBJECT,  INITIALIZE 
R*,W,S,  B29IDPX0/GMFC0L/GJ1F.0BJ 
K*,NULL 
*C ,CCPY 

ERCNT/500/ 

NDECK 

B29DI PXO/GMFCOL/GMF/GMF .  TOP 
B29 1  DP  XO/GMFCOL/MUM/MUM .  I NI T 
829IDPX0/GfFC0L/CPU/CPU. IMIT 
B29IDPX0/GMFC0L/IDLE/IDL .IHIT 
B29I DP  XO/ GT1FCOL/GMF/ GMF . MI D 
B29IDPX0/GMFC0L/CPU/CPU.PAT 
B29IDPXO/GMFCOL/PATLOOK 
B29IDPXO/GMFCOL/CPU/CPUDOIT 
B29IDPX0/6MFC0L/GMF/GMF.M0M 
B29 1 DP  XO/ GMFC  OL/C  P  U/CPU . REMO 
B29IDPX0/GMFC0L/GMF/GMF. BTM 
NDECK 

B29IDPX0/GMFC0L/IDLE/IDL.TRCS 

NDECK 

B29IDPX0//GMFC0L/IDLE/IDL.T21 

NDECK 

B29 1 DP  XO/GMFCOL/MUM/MUM . T1 0 
NDECK 

B29I DP  XO/GMFC  OL/MUM/MUM . T46 
NDECK 

B29I DP XO/GMFCOL/CPU/CPU . T70 


$ 

FILEDIT 

SOURCE, OBJECT, INITIALIZE 

$ 

PRMFL 

R* , W , S , B29I DP XO/ GMFCOL/GMF . OBJ 

s 

FILE 

K*,NULL 

s 

DATA 

*C  .COPY 

s 

LOWLQAD 

$ 

OPTION 

ERCNT/500/ 

$ 

GflAP 

NDECK 

$ 

SELECTA 

B29IDPX0/GWC0L/GMF/GMF.T0P 

$ 

SELECTA 

B29 I DPXO/GMFCOL/MSM/MSM . I MI T 

$ 

SELECTA 

B29IDPXO/GMFCOL/CM/CM. INIT 

s 

SELECTA 

B29 I DPXO/GMFCOL/ I PLE/ I DL . IN I T 

$ 

SELECTA 

B29 1 DP  XO/GMFC OL/GMF/ GMF .MID 

$ 

SELECTA 

B29I DPXO/GMFCOL/MSM/MSM . PAT 

$ 

SELECTA 

B29 1 DP  XO/GMFC OL/PATLOOK 

s 

SELECTA 

B29I DP XO/GMFC OL/MSM/MSMDOIT 

$ 

SELECTA 

B2 9 I DP XO/GMFC OL/GMF /GMF. MOM 

$ 

SELECTA 

B29IDPX0/GMFC0L/MSM/MSM. REMO 

$ 

SELECTA 

B29IDP XO/GMFC OL/GMF/GMF. BTM 

$ 

GMAP 

NDECK 

$ 

SELECTA 

B29IDPX0/GMFC0L/CM/CM.T04A 

$ 

GMAP 

NDECK 

% 

SELECTA 

B29I DP XO/GMFC OL/CM/ CM. T22A 

\ 

GMAP 

NDECK 

$ 

SELECTA 

B2 9 1 DP XO/GMFC OL/CM/CH . TO 7A 

$ 

GMAP 

NDECK 

$ 

SELECTA 

B29 1  DP  XO/GMFC  OL/  IDLE/  IDL  .TP.CS 

$ 

GMAP 

NDECK 

$ 

SELECTA 

B29IDPX0/GMFC0L/IDLE/IDL .T21 

s 

EXECUTE 

$ 

ENDEDIT 

$ 

ENDCOPY 

Figure  5-6.  Creation  of  R*  File  for  Hass  Store 
Monitor,  Idle  and  Channel  Monitor 
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% 

OPTION 

ERCNT/999/ 

$ 

LOWLOAD 

$ 

EXECUTE 

PUMP 

% 

PRfFL 

R* , R , S , B29IDP XO/GMFCOL/GMF . OBJ 

s 

LIMITS 

99.16K 

$ 

PRIVITY 

$ 

TAPE 

0T.X2D,, 99999 

$ 

FILE 

DK  ,X1R,300R 

$ 

DATA 

I* 

MO 

M2  M3  M6  M7 

M8  (optional) 

$ 

ENDJOB 

♦NOTE  -  The  execution  report  from  GMC  will  contain  multiple  "nonfatal 
error"  messages  which  can  be  ignored. 

♦♦NOTE  -  If  high  density  tape  collection  is  desired,  the  tape  card 
should  be  modified  with  the  addition  of  four  commas  after  the  tape 
number  followed  by  the  words  DENI 6: 

$  TAPE  0T.X2D, ,12345, ...DEN16 

and  also  the  option  M;  should  be  on  the  data  card. 


Figure  5-7.  JCL  for  Executing  the  GMC 
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$ 

LOWLQAO 

$ 

OPTION 

ERCKT/500/ 

$ 

EXECUTE 

DUMP 

s 

"RMFL 

R*,R,S,B29IDPXO/GMFCOL/GMF.CBJ 

$ 

LIMITS 

99, 15K,, 99999 

$ 

PRIVITY 

% 

TAPE 

OT ,X2D, , , ,GRTSI I-DATA 

% 

FILE 

DK,X1D,300R 

% 

DATA 

I* 

no 

fll  H2  H3  M4  H5 

M7  M 8  M9  MA 

DO 

;HSLA1 ;SCH0-8, 

14,18,21 -23;D1;R0 

$ 

ENDJOB 

Figure  5-8.  GRTM  JCL 
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JCL  needed  to  execute  a  GMC  session  which  includes  the  GRIM.  Since 
the  GMC  runs  in  master  node,  it  requires  a  PRIVITY  card,  and  the 
operator  oust  grant  it  permission  to  run.  The  DK  file  is  optional  but 
nust  be  present  if  more  than  one  reel  will  be  collected.  The  size  of 
the  DK  file  is  approximately  300  links  but  may  require  more  than  300 
links  on  a  very  busy  system.  This  file  is  used  to  collect  data  during 
rewind  of  a  completed  data  tape.  When  GMF  loads,  many  load  error 
messages  will  be  produced.  These  error  nessages  may  all  be  ignored. 
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SECTION  6.  MEMORY  UTILIZATION  MONITOR  DATA  REDUCTION  PROGRAM 


The  Memory  Utilization  Data  Reduction  Program  (MUDRP)  is  a  FORTRAN  program 
which  uses  the  GMC  output  tape  to  produce  a  series  of  reports  presenting 
various  aspects  of  memory  utilization.  Data  collected  by  the  Idle  Monitor 
will  also  be  processed  by  MUDRP  and  reported  as  part  of  the  MUM  reports. 

6.1  Inputs 

The  Memory  Utilization  Data  Reduction  Program  has  two  inputs.  The  first 
is  the  data  collection  tape  produced  by  the  General  Monitor  Collector 
(see  section  5).  The  second  input  is  a  set  of  control  cards  specifying 
the  output  report  options. 

6.1.1  Report  Options.  The  MUDRP  reports  consist  of  histograms,  serial 
plots,  and  general  report  outputs.  These  reports  have  a  number  of  param¬ 
eter  selections  which  can  be  modified  by  card  input  at  run  time.  Any 
report  may  be  turned  on  or  off,  and  a  set  of  time  spans  may  be  specified 
for  measurement. 

6.1.2  Default  Options.  Table  6-1  lists  all  reports  produced  by  default. 

All  reports  except  the  Memory  Map  and  Out  of  Core  Report  are  produced  unless 
specifically  turned  off,  by  user  request. 

6.1.3  Histogram  Options.  There  are  five  characteristics  for  each 
histogram  directly  available  to  the  user.  These  include  the  ranges 
and  resolution  of  display  as  well  as  the  descriptive  titles.  The 
format  of  a  histogram  report  is  completely  described  later  in  this 
chapter  (section  6.3.2). 

The  first  of  these  characteristics  is  the  lowest  value,  LOWVAL.  Any 
input  received  by  the  histogram  that  is  less  than  this  value  will  be 
entered  into  the  first  histogram  bucket,  along  with  all  entries  that 
are  less  than  the  starting  value  of  the  next  bucket. 

The  next  entry  range,  the  interval  size  of  each  histogram  entry,  is 
determined  by  the  INTVSZ  parameter.  It  specifies  the  size  of  each 
entry  range  or  "bucket." 

The  size  of  the  histogram  is  determined  from  the  parameter  TABSIZ  which 
specifies  how  many  "buckets”  or  entry  ranges  are  contained  in  this  histo¬ 
gram.  TABSIZ  also  specifies  the  upper  value  which  could  fall  within  the 
display  range  of  the  histogram.  If  an  entry  is  made  above  this  range, 
it  is  placed  in  an  out-of-range  "bucket”  of  the  histogram.  The  number 
of  the  out-of-range  occurrences  are  output  with  the  histogram,  along 
with  their  average  value,  so  that  the  histogram  can  be  altered  to  handle 
the  variability  of  the  range  better.  The  user  should  note  that  a  compile 
time  parameter  of  MXTBSZ  determines  how  large  any  one'  histogram  can  be¬ 
come.  If  an  Increase  beyond  this  is  desired,  MXTBSZ  is  increased  along 
with  the  memory  size  of  the  data  reduction  program.  There  are  two  ways 
to  modify  the  histograms  so  as  to  include  the  out-of-range  values.  The 
first  method  would  involve  increasing  the  internal  size  of  a  histogram 
bucket  by  altering  the  value  of  INTVSZ.  In  this  way,  the  histogram  would 
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Table  6-1.  Default  Reports  (Part  1  of  3) 


ID  Number 


Histogram  Title 


1 


Memory  Demand  Size  of  New  User  Activities  in  IK 
Word  Blocks 


3 

4 
3 
6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 


The  Original  Allocation  Time  for  User  Memory  in 
1/10  Second 

The  Total  Elapsed  Time  a  User  Activity  was  Swapped 
The  Number  of  Times  a  User  Activity  was  Swapped 
The  Request  Size  of  GEMORES 

The  Percent  of  Size-Time  Product  Used  by  a  User 
Activity 

The  GEMORE  Service  or  Denial  Time  -  1/10  Second 

The  Elapsed  Time  a  User  Activity  Was  in  Memory 

The  Elapsed  Duration  of  a  User  Activity  in  Tenths 
of  a  Second 

The  Ratio  of  User  Activity  Duration  Versus  Memory 
Use  Time 

The  Memory  Demand  Size  of  All  Demand  Types 

Elapsed  Time  Between  Allocator  Calls  in  1/100  of  a 
Second 

Number  of  Extra  Activities  That  Could  Fit  in  Memory 
With  Compaction 

Number  of  Activities  Waiting  for  Memory  in  the 
Allocator  Queue 

Number  of  Activities  Residing  in  Memory 

Elapsed  Time  of  a  Busy  State  (All  Processors) 

The  Total  Ambunt  of  Available  Memory 

The  Total  Memory  Demand  Outstanding 

Demand  Outstanding  When  a  Processor  Went  Idle 

Number  of  Activities  in  Memory  When  a  Processor  Went 
Idle 
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Table  b-1.  (Part  2  of  3) 


ID  Number 


21 


23 

24 

25 

29 

30 

31 

32 

33 

34 

35 

36 

40 

41 

42 

43 

44 

45 

46 

48 

49 


Histogram  Title 

Number  of  Activities  Waiting  Memory  When  a  Processor 
Went  Idle 

Memory  Available  When  a  Processor  Went  Idle 
Memory  Demand  Size  Versus  Memory  Wait  Time 
used  in  Conjunction  with  ID  23 

Percent  of  Assigned  Memory  Used  (Time-Corrected) 

Number  of  User  Activities  Waiting  Memory  in  the 
Allocator  Queue 

Number  of  User  Activities  in  Memory 
Elapsed  Time  of  a  Busy  State  Processor  0 

Elapsed  Time  of  a  Busy  State  Processor  1 

Elapsed  Time  of  a  Busy  State  Processor  2 

Elapsed  Time  of  a  Busy  State  Processor  3 

CP  Time  per  User  Activity 
I/O  Time  per  User  Activity 

Number  of  Activities  Waiting  Memory  (Time-Corrected) 

Number  of  Activities  in  Memory  (Time-Corrected) 

Memory  Available  (Time-Corrected) 

Number  of  User  Activities  Waiting  Memory  (Time- 
Corrected) 

Number  of  User  Activities  in  Memory  (Time- 
Corrected) 

Total  Demand  Outstanding  (Time-Corrected) 

Number  of  Extra  Activities  That  Could  Fit  in  Memory 
Without  Compaction 

Length  of  an  Idle  State  (All  Processors) 

Length  of  an  Idle  State  Processor  0 
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ID  Number 


Table  6-1.  (Part  3  of  3) 

Histogram  Title 


50 

Length  of  an  Idle  State  Processor  1 

51 

Length  of  an  Idle  State  Processor  2 

52 

Length  of  an  Idle  State  Processor  3 

53 

Number  of  Times  System  Activity  Swapped 

54 

Elapsed  Time  a  System  Activity  was  Swapped 

55 

Elapsed  Time  of  a  Busy  State  Processor  4 

56 

Elapsed  Time  of  a  Busy  State  Processor  5 

57 

Length  of  an  Idle  State  Processor  4 

58 

Length  of  an  Idle  State  Processor  5 

ID  Number /Name 

Plot  Title 

26/PLOT1 

Availability  of  Memory  vs.  Outstanding  Demand  In  Core 
Allocator  Queue  vs.  Outstanding  Demand  in  Peripheral 
Allocator  Queue  Plus  Outstanding  Demand  In  Core 
Allocator  Queue 

27/PLOT2 

Memory  Shortfall  in  Core  Allocator  Queue  vs.  Memory 
Shortfall  in  Core  Allocator  Queue  Plus  Memory  Short¬ 
fall  in  Peripheral  Allocator  Queue 

28/PLOT3 

Number  of  Activities  in  Core  Allocator  Queue  vs. 
Number  of  Activities  in  Peripheral  Allocator  Queue 

59/PLOT4 

Average  size  of  TSS,  FTS  and  NCP 

ID  Number/Name 

Other  Reports 

37/PALC 

Peripheral  Allocator  Report 

38/ ACTIVE 

Activity  Report/Excessive  Resource  Report/Abort 
Report/IDENT  Report 

39 /MAP 

Memory  Map 

4 7 /OUT 

Out  of  Core  Report 

— 

Special  Job  Memory  Reports 
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cover  a  larger  range  of  values.  This  change  could  he  made  via  data  cards 
and  would  not  increase  the  size  of  the  program. 

The  second  method  would  involve  increasing  the  size  of  the  histogram  hy 
altering  the  value  of  TABSIZ.  As  long  as  the  size  requested  does  not 
exceed  50,  this  change  can  also  be  done  via  a  data  card.  However,  if  an 
individual  histogram  needs  to  be  larger  than  50  buckets,  the  user  will 
need  to  change  the  value  of  MXTBSZ.  This  change  will  require  a  change 
to  source  code,  a  recompile,  and  probably,  an  increase  in  program  size. 
All  references  to  MXTBSZ  must  be  altered.  This  would  need  to  be  done 
in  the  EDIT  subsystem  of  Time-Sharing. 

The  remaining  items  that  can  be  modified  are  the  title  and  the  vertical 
axis  headers.  Table  6-2  shows  the  default  values  for  all  histograms. 

6.1.4  Plot  Options.  There  are  three  characteristics  directly  available 
to  the  user  for  each  individual  plot  axis  used. 

The  first  characteristic,  MAXNUM,  is  the  maximum  number  of  entries  to  be 
plotted  on  each  vertical  plot  axis. 

The  second  characteristic,  YMAX,  defines  the  upper  limit  of  the  horizon¬ 
tal  display  axis. 

The  third  characteristic,  YMIN,  defines  the  lower  limit  of  the  horizontal 
display  axis.  Table  6-3  shows  the  default  values  for  all  plots. 

6.1.5  Default  Option  Alteration.  The  general  format  for  an  option 
request  is  as  follows:  The  first  card  contains  an  action  code  describ¬ 
ing  the  action  to  be  taken.  Subsequent  cards  modify  report  parameters 
for  some  of  the  action  codes.  All  input  cards  are  free  format  with  the 
only  requirement  being  that  at  least  one  blank  space  separates  multiple 
input  parameters.  The  very  last  input  card  must  have  the  word  "END" 
typed  on  it.  This  card  must  be  present  whether  or  not  any  other  input 
options  are  selected.  Available  actions  with  their  (default)  implica¬ 
tions  are  shown  in  table  6-4.  There  is  no  order  required  for  the 
options.  In  reading  the  following  sections  it  should  be  remembered 
that  the  first  card  for  any  input  option  must  be  the  action  code  speci¬ 
fication  with  no  other  data  present  on  the  card. 

The  user  should  take  special  note  that  if  this  software  is  executed  under 
a  WW6.4/2H  GCOS  release,  an  additional  data  card  is  required.  This  data 
card  is  not  described  elsewhere  in  this  chapter.  The  data  card  should 
contain  the  letters  RN. 
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Table  6-2.  Default  Values  for  Histograras 


ID  # 

Low  Value 

Interval  Size 

Number  of  Buckets 

1 

4 

4 

40 

2 

0 

50 

40 

3 

0 

250 

40 

4 

0 

1 

40 

5 

4 

4 

40 

6 

0 

1 

45 

7 

0 

5 

40 

8 

0 

200 

40 

9 

0 

200 

40 

10 

.95 

.1 

40 

11 

4 

4 

40 

12 

0 

10 

40 

13 

0 

1 

40 

14 

0 

1 

40 

15 

0 

1 

40 

16 

0.0 

5.0 

45 

17 

0 

10 

40 

18 

4 

10 

40 

19 

4 

20 

40 

20 

0 

1 

40 

21 

0 

1 

40 

22 

4 

8 

40 

23 

4 

4 

40 

25 

50 

2 

40 

29 

0 

1 

40 

30 

0 

l 

40 

31 

0.0 

5.0 

40 

32 

0.0 

5.0 

40 

33 

0.0 

5.0 

40 

34 

0.0 

5.0 

40 

35 

5 

5 

45 

36 

5 

5 

45 

40 

0 

1 

40 

41 

0 

1 

40 

42 

0 

10 

40 

43 

0 

1 

40 

44 

0 

1 

40 

45 

0 

10 

40 

46 

0 

1 

40 

48 

0.0 

5.0 

40 

49 

0.0 

5.0 

40 

50 

0.0 

5.0 

40 

51 

0.0 

5.0 

40 

52 

0.0 

5.0 

40 

53 

0 

1 

45 

54 

0 

250 

40 

55 

0.0 

5.0 

40 

56 

0.0 

5.0 

40 

57 

0.0 

5.0 

40 

58 

0.0 

5.0 

40 
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Table  6-3.  Default  Values  for  Plots 


ID  If  Max  Size  of  Plot 

6  Unlimited 

7  Unlimited 

28  Unlimited 

59  UnliniteJ 


Lower  Plot  Limit 

0. 

0. 

0. 

0. 


Upper  Plot  Limit 

378. 

378. 

63. 

252. 
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Table  6-4. 


Available  Report  Actions  and  Their  (Default)  Values 


HISTG  -  Modify  a  histogram  (see  table  6-2) 

PLOT  -  Modify  a  Plot  (see  table  6-3) 

ON  -  Turn  a  specific  report  on  -  (all  reports  on  except  Memory  Map  and 

Out  of  Core  Report) 

OFF  -  Turn  a  specific  report  off  -  (all  reports  on  except  Memory  Map  and 

Out  of  Core  Report) 

TIME  -  Set  a  time  span  (s)  for  reporting  -  (Total  time  reported) 

ALLOFF  -  Turn  all  reports  off  except  those  specified  -  (all  reports  on 

except  Memory  Map  and  Out  of  Core  Report) 

ALLON  -  Turn  all  reports  on  except  those  specified  -  (all  reports  on 

except  Memory  Map  and  (Xit  of  Core  Repqrt) 

ERROR  -  Do  not  stop  on  an  option  request  error  -  (stop  on  an  Input  error) 
DEBUG  -  Program  debug  requested  -  (no  debug) 

ALLOC  -  Stop  program  after  a  specified  number  of  memory  allocations 
have  been  requested  -  (entire  tape  processed) 

NREC  -  Stop  program  after  a  specified  number  of  tape  records  have  been 
processed  -  (entire  tape  processed) 

NOUSER  -  Do  not  print  USERID  on  any  report  -  (USERID  printed  on  certain 
reports) 

IDLE  -  Turn  off  all  Idle  Monitor  reports  -  (all  IDLE  reports  on) 

WASTED .CORE ,10, CPU, RATIO-  Changes  parameters  used  in  the  Excessive 

Resource  Usage  Report  -  (20K,50K,30MIN,30MIN,  5) 


ABORT  -  SNUMBS  not  to  report  in  the  ABORT  Report  -  (all  SNUMBS  that 
abort  are  reported) 

PLTINT  -  Change  Interval  at  which  plots  are  printed  -  (10  MIN) 

FSTSLV  -  Change  the  lowest  allowable  user  program  number  -  (15  decimal) 

MASTER  -  Define  SNUMBS  that  are  considered  to  be  SYSTEM  jobs  -  (all 
programs  with  a  program  number  less  then  FSTSLV) 

PALC  -  Change  the* p^int  control  for  the  PALC  report  (600  secs) 

END  -  Required  as  last  card  of  input.  It  must  be  present. 

SPECL  r.  Produce  the  Special  Job  Memory  Reports 
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b.l.b.  Histogram  Alterations  (Action  Code  HISTG).  A  complete  description 
of  histogram  default  values  and  their  meanings  is  provided  in  section 
6.1.3.  In  order  to  change  any  histogram  parameter  the  user  is  required 
to  supply  two  data  cards.  The  first  data  card  describes  the  parameter 
to  be  changed  and  the  second  card  provides  the  new  value  for  the  para¬ 
meter.  The  following  options  are  available: 


Card  '/2 


A  new  low  value 
A  new  maximum  histogram  size 
A  new  bucket  size 

A  2-word  header  separated  by  at  least 
one  blank.  Each  header  word  must  not 
exceed  six  characters  in  length.  If 
one  of  the  headers  is  to  be  blank,  the 
word  BLANK  must  be  typed  on  the  data 
card . 

Two  additional  points  must  be  stressed. 

o  The  set  of  parameter  cards  just  described  must  be  preceeded  by 
two  data  cards.  The  first  data  card  contains  the  word  HISTG 
and  second  data  card  contains  the  ID  number  of  the  histogram 
to  be  modified  (see  table  b-1). 

o  When  inputting  the  new  parameter  values  the  user  must  consult 
table  6-2  in  order  to  determine  whether  the  parameters  must  be 
inputted  as  integer  (no  decimal  point) ,  or  as  real  numbers 
(decimal  point  must  appear  on  data  card) . 


Card  #1 

LOWVAL 

SIZE 

BUCKET 

HEADER 


Figure  b-1  shows  a  standard  histogram  format.  Column  five  of  this 
histogram  has  the  words  "NUMBER”  and  "WAIT".  These  are  called  the 
header  labels  and  are  used  to  describe  the  function  being  reported  by 
this  histogram.  It  is  these  two  words  that  the  user  may  modify  with 
the  HEADER  parameter  card.  Figure  6-2  shows  the  input  option  formats 
for  this  action  code. 


6.1.7  Plot  Alterations  (Action  Code  PLOT).  Modifications  to  a  plot 
allow  the  user  to  specify  a  new  plot  size,  a  new  maximum  horizontal  axis 
limit  and  a  new  minimum  horizontal  axis  limit.  The  default  values  foT 
the  existing  plots  are  described  in  section  6.1.4.  As  with  the  histogram 
option  the  user  is  required  to  supply  two  data  cards  for  each  parameter 
change  desired.  The  first  data  card  describes  the  parameter  to  be 
changed  and  the  second  data  card  provides  the  new  value  for  the  param¬ 
eter.  The  following  options  are  available: 


Card  #1 


Card  #2 


SIZE  A  new 
LOWVAL  A  new 
HIVAL  A  new 


maximum  plot  size 
low  value 
high  value 
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Figure  6-1.  Standard  Histogram 


Card  1 

2 

3 

4 

2+N 


A 

B 

C 

D 

E 


repeat  this  set  for  each 
parameter  to  be  changed 


where 


A  «  the  word  HISTG 
B  »  histogram  ID  number  (Table  6-1) 

C  «  parameter  control  word 

D  *  new  parameter  value.  If  parameter  control  word  was 

HEADER  then  this  card  must  contain  two  words  separated 
by  at  least  one  blank.  Each  word  cannot  exceed  six 
characters  in  length.  If  the  user  desires  one  of  the 
words  to  contain  blanks  he  must  type  the  word  BLANK  on 
the  card. 

E  =*  new  action  command  (table  6-4) 


Figure  6.2.  HISTG  Action  Code  Format 
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Several  points  must  be  stressed. 


o  The  set  of  parameter  cards  just  described  must  be  preceded  by 
two  data  cards.  The  first  data  card  contains  the  word  PLOT 
and  the  second  data  card  contains  the  ID  number  of  the  plot 
to  be  modified  (see  table  6-1). 

o  When  Inputting  parameter  values  for  LOWVAL  and  HIVAL  these 
values  must  be  inputted  as  real  numbers  (decimal  point  must 
appear  on  data  card) . 

o  When  inputting  parameter  values  for  SIZE  the  value  must  be 

inputted  as  an  integer.  If  the  size  is  to  be  unlimited  then 
a  -1  must  be  inputted. 

Figure  6-3  shows  a  standard  plot  format.  The  maximum  and 
minimum  values  of  the  plot  are  used  to  determine  the  value  of 
each  dash  across  the  horizontal  axis.  In  this  figure  each 
dash  has  a  delta  value  of  5.00  E-01.  Figure  6-4  shows  the 
format  for  this  input  option. 

6.1.8  Turn  a  Report  On  (Action  Code  ON) .  This  card  allows  a  user  to 
turn  on  a  single  report  that  is  off  by  default.  Card  1  contains  the 
word  ON  and  card  2  contains  the  ID  name  of  the  report  to  be  turned 

on  (Table  6-1).  No  change  to  the  default  parameter,  of  the  report,  will 
be  made.  This  option  may  be  used  only  for  Plots  and  Other  Reports  and 
cannot  be  used  to  control  individual  histograms. 

6.1.9  Turn  a  Report  Off  (Action  Code  OFF).  This  card  allows  a  user  to 
turn  off  a  single  report  that  is  on  by  default.  Card  1  contains  the 
word  OFF  and  card  2  contains  the  ID  name  of  the  report  to  be  turned 
off  (table  6-1).  No  change  to  the  default  parameters,  of  the  report, 
will  be  made.  This  option  may  be  used  only  for  Plots  and  Other  Reports 
and  cannot  be  used  to  control  individual  histograms. 

6.1.10  Set  a  Timespan  of  Measurement  (Action  Code  TIME).  The  t lmespan 
of  data  collection  can  cover  many  hours  of  which  only  a  few  may  be  of 
interest.  This  option  allows  a  user  to  specify  the  timespan  (or  spans) 
to  be  displayed  in  all  reports.  For  example,  the  user  may  specify  that 
he  wants  to  collect  data  from  0500  to  2200  and  wants  to  display  data 
only  from  0900  to  1700  in  all  reports.  As  another  option  the  user  may 
request  to  see  the  memory  map  from  0900  to  1000,  plot  #1  from  1200  to 
1500  and  all  other  reports  from  0800  to  1700. 

The  user  must  specify  the  report  ID  name  to  be  affected  by  the  time  re¬ 
quest  (table  6-1).  If  the  entire  reduction  (all  reports)  are  to  be  time 
controlled,  a  report  ID  name  of  "TOTAL"  must  be  used.  Histogram  reports 
cannot  be  individually  time  spanned.  All  time  spans  of  plots  or  other 
reports  will  be  bound  by  the  total  report  timespan,  if  one  is  to  be  used. 
Up  to  five  timespans  for  each  report  or  plot  may  be  specified,  and  they 
must  be  serially  ordered.  All  times  are  expressed  as  SIMI  where  SI  is 
the  hour  and  MI  is  the  minute.  All  time  must  be  expressed  as  four 
character  fields  with  no  intervening  blanks.  Time  is  based  on  a  24-hour 
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Figure  6.3.  Standard  Plot 


Card  l  A 

2  B 

3  C  repeat  this  set  for  each 

4  D  parameter  to  be  changed 

2+N  E 

A  •  the  word  PLOT 

B  ■  plot  ID  number  (Table  6-1) 

C  -  parameter  control  word 

D  ■  new  parameter  value 

E  ■  new  action  command  (table  6-4) 


Figure  6—4.  PLOT  Action  Code  Format 
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clock.  If  a  user  wants  to  request  the  time  4:07  he  must  input  0407.  All 
times  must  include  four  characters. 

If  a  start  time  but  no  stop  time  is  desired,  no  characters  should  be 
entered  after  the  minutes  of  the  start  time.  If  a  stop  time  is  requested 
there  must  be  a  start  time  corresponding  to  it.  If  the  user  wants  to 
start  at  the  beginning  of  data  collection  and  stop  at  some  specified 
time,  but  is  not  sure  of  the  start  time,  a  start  time  of  0001  should  be 
used.  Figure  6-5  shows  the  format  for  this  option. 

6.1.11  Turn  All  Reports  Off  Except  Those  Specified  (Action  Code  ALLOFF) .  All 
reports  except  those  explicitly  identified  here  are  to  be  turned  off. 

The  inputs  consist  of 


ABC.  .  .  Y  (max  of  25) 

where  A  through  Y  are  the  report  ID  numbers  (table  6-1)  to  be  turned 
on.  The  format  is  shown  in  figure  6-6.  This  option  will  control  the 
printing  of  all  reports,  including  histograms. 

6 . 1 . L 2  Turn  All  Reports  On  Except  Those  Specified  (Action  Code  ALLON). 
All  reports  except  those  explicitly  identified  here  are  to  be  turned  on. 
The  input  consists  of 


A  B  C  ,  .  .  Y  (max  of  25) 

A  through  Y  are  the  report  ID  numbers  (table  6-1)  to  be  turned  off. 

The  format  is  the  same  as  action  code  ALLOFF  (see  figure  6-6).  This 
option  will  control  the  printing  of  all  reports,  including  histograms. 

6.1.13  Continue  Data  Reduction  After  an  Input  Option  Error  (Action  Code 
ERROR) .  This  code  allows  data  reduction  to  continue  when  an  error  has 
been  detected  and  reported  in  an  input  option  request.  The  default  value 
will  abort  data  reduction  and  report  the  error.  Only  the  Action  Code 
card  is  required. 

6.1.14  Debug  For  a  Given  Program  Number  (Action  Code  DEBUG).  This  is 

a  debug  option  which  supplies  large  amounts  of  output  for  a  given  program 
number.  It  should  be  used  only  in  cases  of  data  reduction  problems. 

Card  1  contains  the  word  DEBUG  and  card  2  contains  a  program  number. 

6.1.15  Stop  After  a  Specified  Number  of  Tape  Records  Processed  (Action 
Code  NREC ) .  This  option  is  useful  when  a  tape  problem  occurs  and  the 
entire  tape  cannot  be  processed.  When  this  occurs,  the  program  will 
usually  abort  with  an  I/O  error  and  some  reports  might  be  lost.  If  a 
tape  error  does  occur  during  data  reduction,  the  operator  should  type  a 
"U"  in  response  to  the  operator  action  request  made  by  GCOS  in  processing 
tape  errors.  If  the  operator  performs  this  action  the  data  reduction 
program  will  abort  gracefully. 

Unfortunately  ,  there  are  times  when  a  tape  error  will  cause  a  program 
abort  without  giving  the  operator  a  chance  to  respond  with  a  "U".  In 
these  cases  reports  will  be  lost  and  this  option  will  need  to  be  used 
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Card  1  A 

2  N  M 

3  B  C  D  E  ... 

where 

A  ■  The  word  TIME 

N  =  Report  ID  name  to  be  time  spanned  (table  6-1) 

M  *  Number  of  different  times  appearing  on  Card  3 
B,C,D,E  =  Start  and  stop  times  used  to  define  the  time  spans. 
Times  must  be  separated  by  one  or  more  blanks. 


Figure  6-5.  TIME  Action  Code  Format 
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Card  1  »  A 
2  =  N 

3-BCDE... 

where 

A  =»  The  word  ALLOFF  or  ALLON 

N  *  The  number  of  report  ID's  appearing  on  card  3  cannot  exceed  25 
B,C,D,E  “  ID  numbers  of  those  reports  not  to  be  turned  OFF/ON 


Figure  6-6.  ALLOFF/ALLON  Action  Code  Format 


in  order  to  stop  data  reduction  processing  prior  to  the  tape  error.  The 
first  card  contains  the  word  NRECand  the  second  card  contains  the 
number  of  tape  records  to  be  processed. 

6.1.16  Suppress  USERID  (Action  Code  NOUSER) .  This  action  code  is  used 
to  suppress  the  printing  of  USERIDs  on  those  reports  where  the  USERID 
normally  appears.  Only  the  Action  Card  is  required. 

6.1.17.  Turn  Idle  Reports  Off  (Action  Code  IDLE).  This  option  will 
turn  off  a  histograms  dealing  with  idle  CPU  information  (i.e.  ,  report 
IDs  16,  19,  20,  21,  22,  31-34,  43-54,  55-58).  The  user  should  realize 
that  these  reports  are  useful  in  determining  the  I/O  boundness  of  the 
system.  However,  on  most  systems,  the  idle  trace  is  70  percent  of  the 
entire  tape,  so  that,  by  turning  off  this  processing,  processing  time 
can  be  reduced  by  over  50  percent.  Only  the  action  card  is  required 
for  this  option. 

6.1.18  Change  Excessive  Resource  Limits  Used  in  Excessive  Resource 
Report  (Action  Codes  MASTED,  CORE,  10,  CPU ,  and  RATIO  ) .  This  report 
lists  all  jobs  which  are  above  a  preset  threshold  for  any  of  the  fol¬ 
lowing  resources: 

Wasted  Memory 
Excessive  Memory 
Excessive  CPU  time 
Excessive  I/O  time 
Excessive  Ratio 

These  limits  are  currently  set  to  the  values  specified  in  table  6-4  and 
may  be  changed  by  using  this  option.  The  format  for  this  option  consists 
of  Card  1  specifying  the  action  code  and  Card  2  specifying  the  new 
threshold  limit.  This  report  is  explained  later  in  this  chapter. 

6.1.19  Eliminate  SNUMBs  From  Abort  Report  (Action  Code  ABORT).  This 
report  lists  all  activities  that  fail  to  go  to  EOJ  (i.e.  Abort).  The 
details  of  the  report  are  given  in  section  6.3  of  this  chapter.  At 
times ,  jobs  are  designed  in  such  a  way  that  they  can  be  terminated  only 
via  a  MME  GEBORT  or  operator  command.  While  these  jobs  do  not  go  to 
EOJ,  they  have  processed  correctly  and  have  not  resulted  in  wasted  com¬ 
puter  resources.  This  option  allows  the  user  to  request  that  these  jobs 
not  be  Included  in  the  Abort  Report.  The  first  card  contains  the  action 
code  ABORT.  The  second  card  contains  the  number  of  jobs  that  will  be 
deleted  from  the  Abort  Report.  This  nunfcer  may  not  exceed  10.  If  more 
then  10  jobs  are  listed  only  the  first  10  will  be  deleted.  The  third 
card  contains  the  SNUMB  of  each  job  to  be  deleted.  Each  SNUMB  must  be 
followed  by  at  least  one  blank  column. 

6.1.20  Change  the  Plot  Interval  (Action  Code  PLTINT) .  Currently,  all 
plots  are  outputted  at  ten  minute  intervals.  The  plot  interval  controls 
the  output  of  all  plots;  i.e. ,  one  plot  cannot  have  a  different  time 
Interval  then  another  plot.  The  first  card  of  this  option  contains  the 
action  code  PLTINT.  The  second  card  contains  the  new  plot  Interval 
inputted  in  minutes. 
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6.1.21  Change  the  Program  Number  for  the  First  Slave  Job  (Action  Code 
FSTSLV) .  In  the  GCOS  system  certain  program  numbers  are  assigned  to 
system  jobs.  For  example  $CALC  is  program  number  1,  $?ALC  is  program 
number  2,  $SYOT  is  program  number  3,  etc.  In  the  WWMCCS  system  all 
programs  with  a  program  num5er  less  than  15  (decimal)  are  considered 
system  programs.  This  option  allows  the  user  to  alter  this  program 
number  from  its  default  value  of  15.  The  first  card  contains  the  word 
FSTSLV  and  the  second  card  contains  the  new  program  number.  For  non- 
WWMCCS  systems,  FSTSLV  should  normally  be  set  to  10. 

6.1.22  Request  that  Certain  Jobs  be  Considered  System  Jobs  (Action  Code 
MASTER) .  There  are  certain  jobs  executed  during  the  course  of  a  day, 
which  have  program  numbers  that  would  designate  these  jobs  as  user  jobs. 
However,  in  actuality  they  are  system  jobs  and  should  be  considered  as 
system  overhead.  Examples  of  such  jobs  are  VIDEO,  HEALS,  the  GMF  MONITOR, 
etc.  This  option  allows  the  user  to  define  up  to  ten  jobs  that  should 

be  considered  as  system  jobs.  The  first  card  contains  the  Action  Code 
MASTER.  The  second  card  contains  the  number  of  jobs  to  be  defined  as 
system  jobs.  The  third  card  contains  the  SIIUM3  of  each  job  to  be 
considered  as  a  system  program.  Each  SNUMB  must  be  followed  by  at  least 
one  blank  column. 

6.1.23  PALC  Repqrt  Print  Control  (Action  Code  PALC) .  Due  to  the  excessive 
amount  of  output  possible  from  the  PALC  report,  a  time  control  can  be  set 

to  print  only  those  activities  that  are  in  any  PALC  state  greater  than 
the  time  limit.  This  time  limit  defaults  to  600  seconds  (10  minutes). 

The  first  card  contains  the  word  PALC  and  the  second  card  contains  the 
new  time  limit,  in  seconds. 

6.1.24  Request  the  Special  Job  Memory  Reports  (Action  Code  SFECL) .  If 
the  analyst  desires  to  track  the  memory  demands  for  a  specified  number  of 
jobs  (not  to  exceed  10),  this  input  option  should  be  invoked.  This  option 
will  cause  two  reports  to  be  produced.  One  report  will  indicate  every 
time  the  requested  Job(s)  was  swapped  or  issued  a  MME  GEMORE  for  memory, 
how  long  it  was  swapped,  or  how  long  the  GEMORE  was  outstanding,  and  how 
much  memory  the  Job(s)  required.  A  second  report  will  also  be  produced 
which  indicates  the  average  memory  size  of  the  Job(s)  during  the  course 

of  its  execution.  This  average  is  taken  over  increments  of  tine  where 
the  time  increment  used,  is  the  same  increment  that  is  used  to  produce 
the  series  of  plots.  The  option  consists  of  three  cards  where  the  first 
card  contains  the  word  SPECL,  the  second  contains  the  number  of  Jobs  to 
be  analyzed,  and  the  third  card  contains  the  list  of  SHUMBs  separated  by 
at  least  one  blank  column. 
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Figure  6-7.  System  Bottleneck  Chart 
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6.2  Processing 

6.2.1  General.  The  reports  of  the  MUDRP  are  Intended  to  aid  in  the 
following: 

o  System  sizing  -  both  memory  sizing  and  processor  utilization. 

o  Job  flow  analysis  -  determining  if  and  where  a  bottleneck 
exists  and  the  user  memory  loading  and  the  daily  load 
distributions. 

o  System  perturbation  measures  -  allows  the  user  to  evaluate  how 
a  new  procedure  or  new  load  may  alter  the  utilization  of  the 
system  as  well  as  determine  the  total  utilization/capacity  of 
the  system. 

o  Large  user  jobs  -  aid  in  identifying  specific  jobs  which  are 
misusing  or  "hogging"  system  resources. 

Figure  6-7  illustrates  how  the  monitor  will  pinpoint  these  various  areas. 
For  example,  if  the  monitor  indicates  a  large  percentage  of  processor 
idleness  with  high  memory  demand  and  low  memory  availability,  a  dispatch¬ 
ing  or  I/O  bottleneck  would  be  indicated.  This  would  be  caused  by  the 
I/O  not  completing  its  services  in  a  sufficiently  timely  manner  to  allow 
full  use  of  the  processors.  If  processor  use  was  very  high  and  memory 
demand  and  avallahility  were  high,  a  memory  allocation  bottleneck  or  an 
overloaded  processor  would  be  indicated. 

6.2.2  JCL.  Figure  6-8  presents  the  JCL  needed  to  run  a  total  MUM 
reduction.  The  following  joints  describe  key  features  of  the  required 
JCL. 

o  62K  required  for  memory  +  2K  for  SSAs 

o  15K  sysout  requirement  would  vary  depending  on  amount  of  data 
collected.  This  figure  would  be  significantly  higher  if  the 
Memory  Map  or  Out  of  Core  Report  were  produced. 

o  The  DATA  I*  card  is  used  to  Indicate  the  presence  of  data  cards. 
All  data  cards  must  immediately  follow  this  card.  At  least  one 
data  card  must  be  present.  That  card  will  contain  the  word 
END  and  is  used  to  signify  the  end  of  input  data.  .  The  END  card 
must  be  present  even  if  no  other  data  cards  are  desired. 

o  An  additional  12K  will  be  required  to  load  the  MUM  reduction 
program  but  this  12K  will  be  released  Immediately  upon  loading. 
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Table  6-5  shows  all  the  MUDRP  file  codes  and  their  corresponding  reports. 
6.3  Outputs 

In  this  section,  a  simple  explanation  of  how  each  report  was  derived 
from  the  data  is  given.  Subsection  6.1  discussed  how  the  ranges  and 
other  options  of  each  report  may  be  modified  to  fit  an  individual 
installation. 

Immediately  prior  to  the  output  of  the  histograms ,  the  user  will  find  a 
printout  containing  processing  information.  Included  in  this  information 
is  the  following: 

o  Printout  of  all  input  options  selected  by  user 

o  Indication  of  multireel  tapes  that  are  being  requested  and  have 

been  mounted 

o  Indication  of  the  monitors  that  were  active  during  data  collec¬ 
tion 

o  Error  messages  -  all  error  messages  are  either  self-explanatory 
or  else  followed  by  the  words  "For  Information  Only."  The 
latter  messages  are  used  by  CCTC  for  future  enhancements  and 
as  such  can  be  ignored  by  the  user. 

o  If  the  time  frame  option  was  used,  an  indication  of  when  the 
various  tine  frames  were  reached. 

6.3.1  MUM  Title  Page.  The  Memory  Utilization  Monitor  (MUM)  title  page 
contains  a  summary  of  the  systems  configuration  and  activity  over  the 
measurement  period  (see  figure  6-9).  It  displays  the  time  the  monitor 
was  initiated  and  terminated,  as  well  as  identifying  the  system  which 
was  monitored  and  the  tape  number(s)  containing  the  data.  The  config¬ 
uration  information  is  augmented  by  the  amount  of  memory  dedicated  to 
the  operating  system  Itself ,  including  that  used  by  the  memory  allocation 
program.  These  figures  will  give  the  user  a  good  idea  of  how  much  hard 
core  space  remains  and  could  be  used  for  SSA  module  hard  core  loading. 

If  SSA  cache  is  also  configured  the  amount  of  memory  being  used  for  this 
feature  is  also  listed.  The  version  number  should  be  01-82. 

Immediately  following  is  a  summary  of  the  work  processed  over  the 
measurement  priod.  The  first  set  of  lines  provides  information  concern¬ 
ing  the  overhead  generated  by  the  actual  data  collection.  The  monitor 
name  is  given,  its  CPU  time  in  seconds,  and  its  overhead  as  a  function 
of  total  processor  power.  The  GMF  executive  overhead  is  separated  from 
the  actual  monitors  and  is  listed  as  "EXEC”.  The  monitor  "NAME"  is  an 
area  of  code  within  the  Mass  Store  Monitor  and  even  though  listed 
separately  it  is  also  included  under  the  monitor  'MSM".  The  Monitor 
"FMS"  is  also  an  area  of  code  within  the  Mass  Store  Monitor,  but  in  this 
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Table  6-5.  File  Code  for  MUM  Reports 

20  Activity  Resource  Report,  Special  Job  Reports 

21  IDENT  Report 

27  Activity  Abort  Report 

31  Plot  1  -  (see  table  6-1  for  Plot  Definition)  (temporary  file) 

32  Plot  2  -  (see  table  6-1  for  Plot  Definition)  (temporary  file) 

33  Plot  3  -  (see  table  6-1  for  Plot  Definition)  (temporary  file) 

34  Excessive  Resource  Report 

35  Plot  U  -  (see  table  6-1  for  Plot  Definition)  (temporary  file) 

36  Used  for  outputting  all  plots 

37  Used  for  outputting  Out  of  Core  Report,  Memory  Map,  and 
Peripheral  Allocator  Report 

42  Histograms 

45  Out  of  Core  Report  (temporary  file) 

51  Memory  Map  Report  with  one  file  required  for  each  128K  Memory 
configured  (temporary  file) 

52  Memory  Map  Report  with  one  file  required  for  each  12SK  Memory 
configured  (temporary  file) 

53  Memory  Map  Report  with  one  file  required  for  each  128K  Memory 
configured  (temporary  file) 

54  Memory  Map  Report  with  one  file  required  for  each  128K  Memory 
configured  (temporary  file) 

55  Memory  Map  Report  with  one  file  required  for  each  12SK  Memory 
configured  (temporary  file) 

56  Memory  Map  Report  with  one  file  required  for  each  128K  Memory 
configured  (temporary  file) 

57  Memory  Map  Report  with  one  file  required  for  each  128K  Memory 
configured  (temporary  file) 

58  Memory  Map  Report  with  one  file  required  for  eadh  128K  Memory 
configured  (temporary  file) 

59  Demand  List  Report  (temporary  f ile) 
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case  it  has  not  been  included  under  the  monitor  "MSM".  These  two  special 
areas  of  code,  within  subroutine  T7  (connect  trace  processing),  are  con¬ 
sidered  to  be  high  usage  areas  and  as  such  consume  significant  processing 
resources.  In  order  to  determine  the  true  overhead  of  these  areas,  so 
that  future  code  optimization  can  be  considered,  these  areas  are  being 
reported  separately. 

Monitor  "CM"  in  this  report  describes  the  processor  overhead  of  subrou¬ 
tine  T4  (terminate  processing)  and  subroutine  T22  (start  I/O  processing). 
Monitor  "MSM"  in  this  report  describes  the  processor  overhead  of  sub¬ 
routine  T7  (connect  processing).  Therefore,  if  the  Channel  Monitor  was 
active,  but  the  Mass  Store  Monitor  was  not,  this  report  will  still  list 
both  "CM"  and  "MSM"  as  contributing  to  the  processor  overhead.  The  total 
Channel  Monitor  overhead  will  be  found  by  adding  the  overhead  of  the  "CM" 
monitor,  to  the  overhead  of  the  "MSM"  monitor,  to  the  overhead  of  the 
"FMS"  monitor. 

If  both  the  Channel  Monitor  and  Mass  Store  Monitor  were  active,  then 
the  combined  overhead  of  both  monitors  can  be  found  as  the  sum  of 
"MSM"  +  "CM"  +  "EMS". 

For  purposes  of  this  report  X  overhead  is  computed  as 

(CPUTIME  used  by  monitor) _ 

(Total  Elapsed  Time)  x  (number  of  Processors) 

Following  this  are  several  lines  describing  the  work  performed  during  the 
monitoring  session.  These  lines  are  self-explanatory. 

If  a  termination  record  is  not  processed,  either  because  the  monitor 
aborted  before  a  termination  record  could  be  written  or  else  time  frames 
were  used,  the  lines  describing  GMC  overhead  will  not  be  printed. 

The  number  of  times  a  processor  went  idle  is  derived  from  the  idle  pro¬ 
cessor  traces  captured  by  the  IDLEM,  with  the  percentage  of  processor 
idle  also  being  gathered  by  the  collection  of  idle  state  information. 

This  is  shown  system-wide  (i.e. ,  for  all  the  central  processors  and  then 
individually  for  each  processor).  This  information  will  not  be  present 
if  the  IDLEM  was  not  active  or  if  its  output  reports  have  been  disabled 
by  a  data  card  option  (see  figure  6-10). 

The  number  of  memory  allocator  calls,  as  counted  by  the  monitor,  is  shown. 
This  much  less  than  the  number  of  calls  to  the  multitude  of  SSA  modules 
used  by  the  Core  Allocator  and  consists  only  of  those  that  may  have 
altered  the  memory  state  of  the  system.  The  second  figure  shows  how 
many  times  a  memory  state  change  might  have  taken  place  and  did  not. 

This  could  be  caused  by  no  allocation  being  possible  or  by  a  call  to 
the  allocator  pertaining  to  a  matter  other  than  allocation  (i.e. ,  a 
console  message) . 
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The  next  line  printed  out  is  the  Total  CPU  and  I/O  times  in  seconds  and 
the  ratio  of  CPU  to  10  time.  This  figure  gives  the  user  an  idea  of 
whether  the  workload  processed  by  the  system  is  1/0  or  CPU  dominant.  It 
should  be  noted  that  these  numbers  are  the  amount  of  CPU  and  I/O  time 
generated  during  the  measurement  period. 


The  next  two  lines  give  an  indication  of  whether  the  system  has  a  surplus 
or  shortfall  of  memory  the  weighted  figure  is  calcualted  by  using  the 
following  formula: 


/memory 
s*  lava liable 
t=i  N 


demand 

memory 


TOTAL  TIME 


Where  i  ■  calls  to  the  core  allocator 


-  T^-  length  of  time  over  which  memory  availability  was  in 
this  state. 


If  W  comes  out  positive,  there  is  a  core  surplus  and  if  W  comes  out 
negative,  there  is  a  core  shortfall.  In  the  first  line,  the  demand  for 
memory  is  taken  only  from  the  Core  Allocator's  queue.  In  the  second 
line  the  demand  for  memory  is  taken  from  the  demand  in  both  the  Core 
Allocator  and  Peripheral  Allocator  queues.  The  Peripheral  Allocator's 
queue  consists  of  the  memory  demand  that  is  currently  being  processed  by 
the  Peripheral  Allocator  and  has  not  yet  reached  the  Core  Allocator.  The 
Peripheral  Allocator  will  stop  transferring  jobs  to  the  Core  Allocator 
when  the  Core  Allocator's  queue  reaches  a  predefined  length.  This  second 
figure  presents  a  truer  picture  of  memory  availability.  Jobs  from  the 
Peripheral  Allocator  are  only  included  if  they  have  been  completely 
processed  by  the  Peripheral  Allocator.  These  figures  present  a  good 
first  indication  of  whether  or  not  availability  of  memory  is  a  system 
constraint. 

6.3.2  System  Program  Usage.  The  report  immediately  following  the  title 
page  provides  an  overview  of  the  system  program  load  on  the  memory  sub¬ 
system.  The  data  presented  consists  of  the  following. 

o  Total  Memory  Time  for  This  System  Program  *  100 
Memory  Time  for  all  Programs 

This  figure  would  indicate  what  percentage  of  the  total  memory  time  was 
used  by  this  program. 

o  Percentage  of  the  Elapsed  Time  in  Memory 

o  Total  Size  Time  Product  for  this  System  Program  *  100 
Total  Size  Time  Product  for  all  Programs 
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nils  figure  would  Indicate  what  percentage  of  the  total  size  time  product 
was  used  by  this  program.  The  size-time  product  of  a  job  Is  an  attempt 
to  determine  the  memory  effect  of  a  job  based  not  only  on  its  size,  but 
on  the  length  of  time  that  It  runs.  A  20K  job  that  runs  for  three  hours 
might  be  more  detrimental  to  a  system  than  a  60K  job  that  runs  ten  minutes 


o  Total  Size  Time  Product  for  this  System  Program  *  100 
Total  Size  Time  Product  Available  to  System 

Where  Total  Size  Time  Product  Available  to  System  «  (The  Elapsed  Run 
Time)  *  (Total  Allocatable  Memory) 

The  next  two  figures  are  weighted  memory  sizes  for  this  program.  The 
first  figure  is  the  weighted  memory  size  of  this  program  while  It  Is 
in  memory.  Therefore,  if  TSS  was  in  memory  during  three  different 
time  periods  for  1/2  hour,  3/4  hour,  and  one  hour,  and  during  these 
periods  its  memory  size  was  40K,  100K,  180K  respectively,  its  weighted 
in  memory  size  would  be  calculated  as  follows: 

Weighted  (IN)  -  (40)*(.5)+(100)*(.75)+(180)»(l) 

2.25 

-  j!75  -  122K 
2.25 

Had  the  calculation  not  been  weighted  by  time  the  average  size  of  TSS 
would  have  been: 

(40) +(100) +(180)  -  73K 


In  the  above  calculation,  the  report  would  be  stating  that  the  amount  of 
memory  being  taken  away  from  the  system,  by  TSS,  was  122K.  However, 
what  if  TSS  was  swapped  for  50  percent  of  the  total  elapsed  time.  Then 
TSS  really  did  not  take  122K  from  the  system,  but  rather  only  61K.  The 
second  weighted  figure  takes  into  account  the  total  time  the  program  was 
actually  in  memory. 

The  final  figure  la  the  number  of  times  this  program  was  swapped. 

In  addition  to  the  standard  system  programs,  any  jobs  requested  by  the 
user,  to  be  considered  as  system  jobs,  also  appear  in  this  report.  In 
<  figure  6-11  we  see  six  user  requested  jobs  appearing  on  the  report.  The 

user  had  actually  requested  nine  jobs  to  be  considered  as  system  jobs, 
but  three  of  those  jobs  never  appeared.  In  a  system  using  multicopies 
of  TSS  only  TS1  (prog  #5)  will  appear  in  this  report.  Other  copies  of 
TSS  must  be  requested  by  user  input  option  PIASTER”. 

6.3.3  MOM  Reports.  The  following  paragraphs  describe  the  reports  output 
by  MUM. 

Report  numbers  1-50  are  all  presented  in  a  histogram  format  (see  figure 
6-12).  At  the  top  of  the  report,  the  system  name,  as  well  as  the  time 
and  date  of  data  collection,  are  given.  This  is  followed  by  the  title 
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line  of  the  histogram.  Column  number  1  indicates  the  number  of  occur¬ 
rences  of  a  given  event,  with  column  number  5  describing  the  event.  In 
figure  6-12,  we  find  that  229  times  there  were  0  user  activities  in 
memory,  while  2899  times  there  were  five  activities  in  memory.  Column 
number  2  is  simply  a  running  total  of  column  number  1.  -Therefore,  the 
second  line  in  column  number  2  (2008)  is  merely  a  running  total  of  the 
first  two  lines  of  column  number  1  (229  +  1779).  The  fourth  column  is 
the  percentage  of  all  activities  which  will  fall  into  that  line  of  the 
report  showed  two  user  activities  in  memory.  For  example,  4063  entries 
out  of  a  total  23410  entries.  This  results  in  a  17.35  percentage  figure. 
This  means  that  17.35%  of  all  measurements  (4063/23410)  showed  2  activi¬ 
ties  being  in  memory.  Column  number  3  is  simply  a  running  total  of 
column  number  4.  It  presents  the  percentage  of  measurements  which  will 
fall  into  a  given  line,  or  earlier  line.  For  example,  25.93Z  of  all 
measurements  showed  the  number  of  activities  in  memory  to  be  2  or  less. 
There  is  a  graphic  display  of  these  measurements  presented  to  the  right 
of  the  fifth  column.  At  the  bottom  of  the  report,  summary  information 
is  provided  and  is  calculated  in  the  standard  statistical  manner. 

In  figure  6-13,  we  see  a  similar  histogram  report.  As  displayed  by 
column  5,  we  find  that  each  line  of  the  histogram  represents  a  range 
of  values,  with  an  interval  size  of  200.  This  interval  size  can  be 
modified  by  the  user.  The  lowest  value  in  this  histogram  is  0  (modifi¬ 
able  by  the  user)  and  the  size  of  the  histogram  defaults  to  45  lines 
(also  modifiable  by  the  user).  Actually  for  this  run,  the  lowest 
value  recorded  was  42.  Since  we  can  output  only  45  lines  and  each  line 
represents  a  range  of  values  of  200,  the  largest  value  that  could  be 
reported  would  be  9,000  (200  X  45).  If  a  measurement  falls  outside  this 
maximum  value.  It  is  reported  as  an  out-of-range  value.  In  figure  6-13, 
we  find  the  21  measurements  exceeded  9,000.  The  average  of  these  21 
measurements  was  20188.48.  The  first  line  of  the  summary  Includes  all 
measurements  that  were  taken.  Therefore,  21  out  of  79  entries  (26  per¬ 
cent)  of  all  measurements  were  out  of  range.  The  average  of  all  measure¬ 
ments  taken  was  5953.62,  while  the  average  of  the  in-range  measurements, 
(all  out  of  range  values  are  eliminated)  was  799.62. 

6. 3.3.1  Report  1  -  Memory  Demand  Sizes  of  New  Activities  in  IK  Word 
Blocks.  This  report  shows  the  demand  size,  in  lK-word  blocks,  of  each 
individual  user  activity  as  it  was  first  seen  by  the  memory  allocator. 

The  demand  sizes  are  presented  to  the  allocator  by  the  Peripheral 
Allocator.  This  is  a  good  measure  of  the  memory  demand  load  of  a  systems 
operation  and  can  be  used  to  set  System  Scheduler  classes  to  correctly 
balance  the  load  across  varying  memory  size  jobs.  In  this  type  of  report, 
the  distribution  shows  the  percentage  of  activities  which  had  a  partic¬ 
ular  memory  size.  For  this  report ,  an  entry  is  made  for  each  new 

user  activity  demand  at  each  allocator  call.  See  Report  10  for  an  expla¬ 
nation  of  user  vs.  system  activity. 

6. 3. 3. 2  Report  2  -  The  Memory  Demand  Size  of  All  Demand  Types.  This 
report  contains  the  information  in  Report  1,  with  the  addition  of  all 
other  individual  demand  types.  These  include  activities  that  are  swapped 
or  involved  in  a  memory  compaction  procedure.  This  report  should  be 
similar  to  Report  1,  unless  a  great  amount  of  GEM0RE,  GERLEC,  or  swap 
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DISTRIBUTION  COLLECTED  ON  SYSTEM  NMCC2  AT  18:50:03 


i 

l 

\ 


co 


o  m 


w 

>  CO  M  OS  N  vfi  VO  CM  vO  \0  rs  sOnOnO  CM  vO 

U  MO  st  CM  CM  CO  vO  NO  n  VO  sO  ON  sO  vO  sO  CO  vO 

X  p  CC  CO  N  <n  m  <N  CM  lO  CM  CM  O  CM  CM  CM  iO  CM 

H  Zb  •  •••••••««••••••»••••• 

M  NNvOCMho^NhOhOOOhhhOcMOOh 

CM 


COOOsOvflvflCMM'ONOMnnrOnOS'JOONNNOO 

^NosoososvooMnmNCNNWoomNNininifiH 

COmoO't'OvOOS'tN^OOOoOflOOfOvO'O^-M^sf 

N/lH-tift»AsOOsOON^ininNflOOsOScMNCMO 

N«t«n«)inininins0'0'0'fiv0s0'0'0v0^rNNNN 


M'OHfO^>tinM»OOOWNNN(0'tininp%NNQO 
cm  co  st  <t  »t  tM'-tiAini^in^ifl^inininio 


(N<rmiNHOH(NHOHnOOHHHONOOH 

CM 


6-33 


79  ENTRIES  TOTAL  AVERAGE  -  5953.62024  VARIANCE  -  04446990.000  STANDARD  DEVIATION  -  10219.931 
21(26X)  OUT  OF  RANGE  AVERAGE  FOR  THESE  -  20188.48  IN  RANGE  AVERAGE  -  799.62 


operations  are  performed  by  the  users  load.  This  would  alter  the  memory 
size  demands  from  that  seen  by  the  allocator  at  the  initial  request.  For 
this  report,  an  entry  is  made  for  each  activity  with  an  outstanding  demand 
for  each  allocator  call.  Jobs  with  an  urgency  of  0  are  not  counted. 

6. 3. 3. 3  Report  3  -  The  Total  Memory  Demand  Outstanding.  This  report 
shows  the  sun  of  demand  for  all  activities  in  the  system  including  out¬ 
standing  GEMOREs.  It  is  a  distribution  of  memory  demand  that  is  not 
satisfied,  across  the  measurement  session.  It  should  be  remembered  that 
all  data  is  collected  at  the  Core  Allocator  and  does  not  represent  the 
full  system  load.  Portions  of  the  load  may  be  held  in  the  System 
Scheduler  and  the  Peripheral  Allocator. 

For  this  report,  an  entry  is  made  at  each  allocator  call. 

6. 3. 3.4  Report  4  -  The  Demand  That  Was  Outstanding  When  a  Processor 
Went  Idle.  This  report  is  the  same  as  Report  3,  except  that  an  entry 

is  made  only  if  a  processor  has  gone  idle  since  the  last  allocator  call. 

If  a  large  demand  should  be  outstanding  during  processor  idleness,  a 
system  bottleneck  may  be  present.  In  this  case,  memory  is  probably 
fully  utilized  (i.e.  ,  demand  cannot  be  satisfied),  but  the  jobs  that  are 
occupying  memory  are  not  using  the  processor,  (i.e.,  a  processor  has 
gone  idle).  This  is  a  good  sign  of  an  I/O  backlog.  Several  of  the 
CPU  reports  described  in  chapter  11  can  be  used  to  verify  this  hypothesis. 
IDLEM  data  is  used  to  produce  this  report. 

6. 3. 3. 5  Report  5  -  The  Total  Amount  of  Available  Memory.  The  total 
amount  of  available  memory  is  a  key  indicator  of  the  system  memory 
utilization.  If  this  amount  is  continually  low,  the  memory  is  being 
fully  utilized  and  possibly  in  need  of  expansion.  A  continually  high 
amount  may  indicate  another  system  bottleneck  or  an  excess  of  memory. 

This  report,  when  used  in  conjunction  with  Reports  3,  4,  and  6  should 
give  a  good  first- level  indication  of  system  memory  utilization.  It 
should  be  noted  that  the  availability  shown  here  exists  in  all  quadrants. 
The  availability  Is  the  sum  of  any  and  all  "holes"  In  the  system  and 
does  not  mean  that  this  memory  Is  contiguously  available. 

The  average  value  reported  in  this  report  minus  the  average  value 
reported  in  report  3  will  give  a  good  feel  for  memory  surplus  or 
shortfall.  A  positive  result  will  indicate  a  surplus  while  a  negative 
result  will  indicate  a  shortfall.  The  MUM  heading  report  also  gives  a 
surplus/shortfall  indicator. 

For  this  report,  an  entry  is  made  for  each  allocator  call. 

6. 3. 3. 6  Report  6  -  The  Memory . Available  When  a  Processor  Went  Idle.  The 
previous  report  is  repeated  with  the  additional  restraint  that  a  processor 
has  gone  idle  since  the  last  allocator  call.  This  aids  in  identifying 
either  a  bottleneck  or  a  lightly  loaded  system. 
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For  this  report,  an  entry  is  made  at  each  allocator  call  that  had  a 
processor  go  idle  since  the  last  allocator  call.  IDLEM  data  is  used 
to  produce  this  report.  This  report  will  not  be  produced  if  IDLEM 
was  not  active  or  the  IDLEM  Reports  have  been  disabled  via  user  input 
command . 


6. 3. 3. 7  Report  7  -  The  Time  Corrected  Total  Demand  Outstanding.  See 
report  16  for  an  explanation  of  time  correction.  The  time  corrected 
total  demand  is  the  sum  of  all  requests  for  memory  known  to  the  alloca¬ 
tor  as  indicated  in  Report  3.  Jobs  with  urgency  0  are  not  counted. 

6. 3. 3. 8  Report  8  -  The  Time-Corrected  Memory  Available.  See  Report  16 
for  an  explanation  of  time  correction.  This  report  reflects  the  time- 
corrected  amount  of  total  memory  available  as  indicated  in  Report  5. 

6. 3. 3. 9  Report  9  -  The  Number  of  Activities  Waiting  for  Memory  in 
Allocator  Queue.  This  report  identifies  the  depth  of  the  allocator 
demand  queue  and  includes  all  activities  that  are  waiting  for  memory 
allocation.  It  aids  in  determining  if  too  many  or  too  few  jobs  are 
getting  to  the  Core  Allocator  from  the  Peripheral  Allocator.  For  this 
report,  an  entry  is  made  at  each  allocator  call. 

6.3.3.10  Report  10  -  The  Number  of  User  Activities  Waiting  Memory  in 
Allocator  Queue.  This  report  is  the  same  as  Report  9  except  that  it 
only  counts  those  activities  of  a  slave  job  as  identified  by  their 
program  number  (program  number  15  or  greater).  In  order  to  change 
this  program  number  test  the  user  should  see  Input  Action  FSTSLV.  In 
addition,  the  user  may  specify  up  to  ten  additional  programs  that  he 
wants  considered  as  system  programs,  even  though  their  program  number 
exceeds  15.  The  user  should  see  Input  Action  '.ASTER  in  order  to  select 
this  option.  This  report  indicates  the  "user"  work  waiting  allocation. 
For  this  report,  an  entry  is  made  on  each  allocator  call. 

6.3.3.11  Report  11  -  The  Time-Corrected  Number  of  Activities  Waiting 
Memory ♦  See  Report  16  for  an  explanation  of  time  correction.  This 
report  indicates  the  time-corrected  number  of  activities  waiting  memory 
as  in  Report  9. 

6.3.3.12  Report  12  -  The  Time-Corrected  Nunber  of  User  Activities 
Waiting  Memory.  See  Report  16  for  an  explanation  of  time  correction. 
This  report  indicates  the  time-corrected  number  of  user  jobs  waiting 
memory  in  the  allocators  queue  as  in  Report  10.  See  Report  10  for 
additional  user  options. 

6.3.3.13  Report  13  -  The  Humber  of  Activities  Waiting  Memory  When  a 
Processor  Went  Idle.  Report  9  is  the  basis  for  this  report,  with  the 
additional  criteria  that  a  processor  must  have  gone  idle  since  the  last 
allocator  call.  An  entry  is  made  for  each  allocation  where  a  processor 
has  gone  idle  since  the  last  call.  IDLEM  data  is  used  to  produce  this 
report.  This  report  will  not  be  produced  if  IDLQf  is  not  active  or  the 
IDLEM  reports  were  disabled  via  user  input  commands. 


6.3.3.14  Report  14  -  The  Number  of  Activities  Residing  In  Memory.  This 
report  represents  the  number  of  activities  allocated  memory.  It  indi¬ 
cates  the  multiprogramming  depth  the  system  is  obtaining.  It  is  probably 
an  upper  level  since  an  activity  is  allocated  memory  prior  to  and  past 
actual  usage.  For  this  report,  an  entry  is  made  for  each  allocator  call. 

6.3.3.15  Report  15  -  The  Number  of  User  Activities  in  Memory.  The 
activities  shown  in  this  report  are  those  that  are  in  memory  and  have  a 
program  number  greater  than  or  equal  to  15.  These  are  user  programs. 

For  this  report,  an  entry  is  made  at  each  allocator  call.  See  Report  10 
for  additional  user  options  in  defining  system  jobs  and  user  jobs. 

6.3.3.16  Report  16  -  The  Time-Corrected  Number  of  Activities  in  Memory. 
This  report  presents  the  same  information  as  in  Report  14.  The  number 
of  entries  at  each  allocator  call  is  determined  by  the  time  since  the 
last  allocator  call.  The  result  is  a  simulation  of  a  uniform  sample 
rate  of  allocator  calls.  Therefore,  the  noncorrected  reports  display 
the  distributions  as  seen  by  the  allocator  itself.  The  time  corrected 
reports  present  the  time  weighted  distributions.  As  an  example  assume 
that  three  measurements  are  taken.  It  is  found  that  six  activities 

are  in  memory  for  two  minutes,  20  activities  for  five  minutes,  and 
eight  activities  for  one  minute.  The  average  number  of  activities  in 
memory  is  (6+20+8) /3»11.  If  we  correct  for  time  however,  we  get 
((6)*(2)+(8)+(20)*(5))/8*100/8»12.5  activities  in  memory.  The  division 
of  8  was  the  total  time  (5+2+1)  spent  collecting  data.  All  of  the 
time-corrected  reports  are  of  the  same  nature. 

6.3.3.17  Report  17  -  The  Time-Corrected  Number  of  User  Activities  in 
Memory.  This  report  indicates  the  time-corrected  number  of  user  jobs 
with  allocated  memory  as  in  Report  15.  See  Report  10  for  additional 
user  options  in  defining  system  jobs  and  user  jobs.  See  Report  16  for 
a  definition  of  Time  Correction. 

6.3.3.18  Report  18  -  The  Number  of  Activities  in  Memory  When  a  Processor 
Went  Idle.  This  report  Indicates  the  total  number  of  activities  with 
allocated  memory  when  a  processor  went  idle.  This  report  can  show  an 
I/O  bottleneck  if  the  multiprogramming  depth  is  high  but  there  is  no 
work  for  a  processor  to  perform.  For  this  report,  an  entry  is  made  on 
each  allocator  call  for  which  a  processor  went  idle  since  the  last  call. 
IDLEM  data  is  used  to  produce  this  report.  This  report  will  not  be 
produced  if  IDLEM  is  not  active  or  if  IDLEM  reports  have  been  disabled 

by  user  input  options. 

6.3.3.19  Report  19  -  The  Ratio  of  User  Activity  Duration  Versus  Its 
Memory  Use  Time.  This  report  indicates  the  ratio  of  total  elapsed  time 
(Report  20)  over  the  total  allocated  memory  time  (Report  21).  This  shows 
how  activity  run  time  is  stretched  due  to  resource  contention. 

For  this  report,  an  entry  is  made  for  each  user  activity  that  terminates. 
See  Report  10  for  an  explanation  of  user  vs.  system  activities. 
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6.3.3.20  Report  20  -  The  Elapsed  Duration  of  User  Activity  In  lOths  of 

a  Second.  This  report  presents  the  clock  time  that  the  allocator  knew  of 
a  user  activity's  existence,  measured  from  its  first  memory  demand  to  its 
termination.  This  includes  all  time  spent  in  a  GEWAKE,  in  memory,  and 
swapped. 

For  this  report,  an  entry  is  made  for  each  user  activity  that  terminates. 
See  Report  10  for  an  explanation  of  user  vs.  system  activities. 

6.3.3.21  Report  21  -  The  Total  Elapsed  Time  a  User  Activity  Was  in 
Memory .  This  report  shows  the  duration  of  elapsed  clock  time  each  user 
activity  had  memory  allocated  to  it.  It  helps  describe  the  system  work¬ 
load  requirements. 

For  this  report,  an  entry  is  made  for  each  user  activity  that  terminates. 
See  Report  10  for  an  explanation  of  user  vs.  system  activities. 

6.3.3.22  Report  22  -  The  GEMORE  Service  or  Denial  Time  -  1/10  Second, 
Elapsed.  The  time  from  a  GEMORE  request  until  the  activity  is  allocated 
the  extra  memory ,  swapped  to  achieve  the  additional  memory ,  or  denied 
the  memory  is  displayed  in  this  report. 

For  this  report,  an  entry  is  made  for  each  activity  whose  GQIORE  request 
is  no  longer  present. 

6.3.3.23  Report  23  -  The  Request  Size  of  GEMOREs.  All  GEMORE  requests 
are  shown  in  this  report  with  the  displayed  size  in  IK  blocks. 

For  this  report,  an  entry  is  made  for  each  GEMORE  request. 

6.3.3.24  Report  24  -  Not  Output.  Report  24  is  used  within  the  data 
reduction  as  a  buffer  for  the  two  levels  of  information  necessary  for 
Report  25  and  is  not  an  available  report  for  display. 

6.3.3.25  Report  25  -  The  Memory  Demand  Size  Versus  the  Memory  Wait  Time. 
This  report  is  the  only  dual-axis  (averaged)  histogram  and  displays  the 
relationship  of  memory  demand  size  and  the  wait  time  for  its  allocation. 
This  report  will  show  if  the  allocator  or  workload  is  biased  in  its 
services.  The  vertical  axis  represents  a  single-axis  histogram  and 
contains  the  memory  demand  sizes.  The  information  to  the  left  of  the 
sizes  is  a  count  of  the  entires  in  each  interval.  The  horizontal  axis 
displays  the  averaged  wait  time  for  all  the  entires  of  a  particular  size 
Interval.  This  is  in  contrast  to  the  single-axis  histogram  which  shows 
merely  the  occurrence  distribution.  The  scale  of  this  axis  is  determined 
from  the  data;  the  lowest  and  highest  scale  values  represent  the  shortest 
and  longest  averaged  wait  times  that  have  occurred.  The  time  interval  of 
each  X  is  given  as  the  DELTA  on  the  report  and  the  actual  averages 
obtained  for  each  entry  are  displayed  under  AVERAGE. 

The  histogram  is  derived  by  accumulating  the  sum  of  the  wait  times  for 
each  interval  size  and  dividing  by  the  total  number  of  entries  in  that 
interval.  This  supplies  the  average  memory  wait  time  for  that  interval 
or.  demand  size.  The  statistics  shown  below  the  histogram  pertain  to 
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the  vertical  axis  followed  by  the  statistics  of  the  average  wait  times 
of  the  horizontal  axis.  The  minimum  and  maximum  times  shown  are  those 
for  all  wait  times  and  are  not  the  averages. 

For  this  report,  an  entry  is  made  whenever  an  allocation  of  memory  is 
made  (refer  to  figure  6-14). 

6.3.3.26  Reports  26  through  31  -  The  Elapsed  Time  of  a  Busy  State  of 
the  Processors.  These  reports  present  the  elapsed  clock  time  between 
the  idle  states  of  each  Individual  processor.  The  reports  supply  an 
indication  of  how  each  processor  is  utilized  versus  the  others  in  the 
system. 

For  these  reports,  an  entry  is  made  at  each  idle  state  of  a  processor. 
IDLEM  data  is  used  to  produce  these  reports.  These  reports  will  not  be 
produced  if  the  IDLEM  was  not  active  or  if  the  IDLEM  reports  have  been 
disabled  by  user  input  option. 

6.3.3.27  Report  32  -  The  Elapsed  Time  of  a  Busy  State  of  Processors. 

The  elapsed  clock  time  between  idle  states  of  all  processors  is  presented 
in  this  report. 

For  this  report,  an  entry  is  made  for  each  processor  idle  state.  IDLEM 
data  is  used  to  produce  this  report. 

6.3.3.28  Report  33  -  Elapsed  Time  Between  Allocator  Calls  in  1/100  of 

a  Second.  This  report  shows  the  elapsed  clock  time  between  calls  to  the 
allocator  and  shows  if  the  allocator  is  receiving  sufficient  service. 

For  this  report,  an  entry  is  made  on  each  allocator  call. 

6.3.3.29  Report  34  -  The  I/O  Time  Charged  per  User  Activity  in  Seconds. 
This  report  indicates  the  I/O  time  charged  to  each  user  activity. 

For  this  report,  an  entry  is  made  for  each  user  activity  that  terminates. 

6.3.3.30  Report  35  -  The  CP  Time  Charged  per  User  Activity  in  Seconds. 
This  report  presents  the  CP  time  charged  to  each  user  activity.  For 
this  report,  an  entry  is  made  for  each  user  activity  that  terminates. 

Reports  34  and  35  report  the  total  CPU  and  I/O  times  used  by  a  user 
activity  while  the  monitor  was  active.  These  histograms  are  not  gener¬ 
ated  for  programs  with  program  numbers  less  than  15  (i.e. ,  system  pro¬ 
grams).  See  Report  10  for  additional  user  options  in  defining  system 
activities  and  user  activities. 

6.3.3.31  Report  36  -  The  Number  of  Times  a  User  Activity  Was  Swapped. 
This  report  shows  the  swap  count  per  user  activity.  The  total  number  of 
swaps  a  user  activity  incurs  is  the  user  argument ,  as  counted  by  the 
monitor.  See  Report  10  for  additional  user  options  in  defining  system 
activities  and  user  activities. 

For  this  report,  an  entry  is  made  for  each  user  activity  that  terminates. 
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6.3.3.32  Report  37  -  The  Total  Elapsed  Time  a  User  Activity  Was  Swapped. 
This  report  indicates  the  total  time  a  user  activity  was  inactive  due  to 
a  swap.  After  each  swap  is  completed,  an  accumulator  is  updated,  and  if 
an  activity  is  terminated,  an  entry  is  made  to  this  report.  See  Report 
10  for  additional  user  options  in  defining  system  activities  and  user 
activities. 


6.3.3.33  Report  38  -  The  Number  of  Times  a  System  Activity  Was  Swapped. 
This  report  is  the  same  as  Report  34  except  for  system  activities.  See 
Report  10  for  additional  user  options  in  defining  system  activities  and  ' 

user  activities. 

6.3.3.34  Report  39  -  The  Total  Elapsed  Time  a  System  Activity  Was  Swapped. 
This  report  is  the  same  as  Report  35  except  for  system  activities.  See 
Report  10  for  additional  user  options  in  defining  system  activities  and 
user  activities. 

6.3.3.35  Report  40  -  Number  of  Extra  Activities  That  Might  Fit  in  Memory 
Using  Compaction.  This  report  shows  how  memory  might  have  been  used  more 
optimally.  It  takes  the  total  amount  of  available  memory  (displayed  in 
Report  5)  and  attempts  to  fit  in  those  activities  waiting  memory.  If  an 
activity  fits,  the  memory  available  is  decreased,  and  the  next  activity 
is  tried.  If  an  activity  does  not  fully  fit,  the  next  activity  is  tried. 
This  continues  until  all  available  memory  is  used  or  until  all  the  activ¬ 
ities  waiting  have  been  tried.  The  search  starts  at  the  first  waiting 
program  and  progresses  serially  down  the  program  numbers  of  those  waiting. 
This  search  ignores  the  actual  size  of  "holes"  or  quadrant-crossing  and 
is  not  necessarily  obtainable  or  optimal.  For  this  report,  an  entry  is 
made  at  each  allocator  call. 

6.3.3.36  Report  41  -  Number  of  Extra  Activities  That  Might  Fit  Memory 
Without  Compaction.  This  report  is  the  same  type  as  Report  40.  In 
this  case,  activities  are  fit  into  existing  holes  and  are  ordered  by 
urgency.  The  search  progresses  down  the  activities  serially,  beginning 
at  the  highest  urgency  activity.  This  histogram  presents  a  good  picture 
of  how  well  the  core  allocator  is  performing  its  function. 

For  this  report,  an  entry  is  made  at  each  allocator  call. 

6.3.3.37  Report  42  -  The  Percent  of  Size-Time  Product  Used  by  a  User 
Activity.  This  report  shows  the  percentage  of  user  each  activities' 
size-time  product  over  its  run-time  duration.  An  entry  is  made  for 
each  user  activity  that  terminates.  See  Report  10  for  an  explanation 
of  user  and  system  activities. 

6.3.3.38  Report  43  through  49  -  The  Length  of  Idle  State  in  the 
Processors.  The  elapsed  clock  time  of  an  idle  state  is  given  in  these 
reports  for  each  individual  processor  and  also  as  an  average  for  all 
processors.  They  supply  an  indication  of  how  each  processor  was 
utilized  versus  the  others  in  the  system.  They  also  provide  information 
on  how  busy  the  processors  are.  These  reports  should  be  used  in  con¬ 
junction  with  Reports  26  through  32. 
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IDLEM  data  Is  used  to  produce  these  reports.  These  reports  will  not  be 
produced  if  IDLEM  was  not  active  or  if  the  IDLEM  reports  have  been 
disabled  by  user  input  command. 

6.3.3.39  Report  30  -  Original  Allocation  Time  for  User  Memory  in  1/iO 
Second.  This  report  gives  the  time  each  user  activity  waited  for  its 
original  allocation  of  memory.  See  Report  10  for  an  explanation  of  user 
and  system  activities. 

6.3.3.40  Report  51  -  The  Time-Corrected  Percent  of  Assigned  Memory  Used. 
This  report  gives  the  t iae-corrected  percentage  of  slave  memory  used 
over  the  monitoring  period.  See  Report  16  for  a  definition  of  Time 
Correction. 

6.3.4  Activity  Resource  Usage  Report.  For  each  activity  known  to  the 
monitor,  a  detailed  Resource  Usage  Report  is  made  upon  termination  of 
the  activity.  The  report  is  ordered  by  termination  time  sequence,  and 
the  resource  usage  is  that  known  to  the  system  at  the  last  allocator  call 
(refer  to  figure  6-15). 

Each  activity  is  displayed  via  the  SNUMB  and  activity  number  followed  by 
the  CP  and  I/O  charge  times  expressed  in  milliseconds.  This  the  CP  and 
I/O  times  generated  during  the  monitoring  session.  The  size-time  product 
is  the  total  K  words  times  the  microseconds  of  allocation  time,  which 
gives  a  better  expression  for  the  memory  used  by  the  job  than  the  size 
of  the  job.  The  minimum  and  maximum  core  requirements  of  the  job  are 
then  shown,  including  the  activity  Slave  Service  Areas  (SSAs)  as  well 
as  slave  size. 

The  elapsed  time,  in  hours,  an  activity  was  known  to  the  allocator  is 
followed  by  the  number  of  times  the  job  size  changed  for  any  reason. 

The  wasted  core  column  is  calculated  from  the  job  Slave  Prefix  Area 
(SPA)  word  37  octal.  This  is  filled  by  the  System  Loader  and  may  not 
be  valid  for  all  job  types  (i.e.  ,  an  H*  file  is  not  loaded  in  the  normal 
system  load  manner).  This  column  is  shown  in  order  to  help  locate  users 
that  do  not  have  the  $LIMITS  card  set  correctly  for  the  memory  being 
used.  If  the  user  appears  to  be  requesting  excessive  core  on  his  $LIMITS 
card,  he  may  be  using  this  extra  space  as  a  spare  buffer  area.  If  this 
figure  shows  an  excessive  misuse  of  the  ^LIMITS  card,  the  user  should  be 
contacted  and  questioned. 

The  next  two  columns  provide  a  count  of  the  total  number  of  swaps  and 
moves  incurred  by  the  activity.  The  final  columns  of  the  entry  gives 
memory  allocation  time,  wait  time,  swap  time,  memory  time,  and  GEWAKE 
time,  all  in  tenths  of  a  second  for  each  activity.  An  entry  will  be 
made  in  this  report  for  every  activity  of  a  job,  when  the  activity 
completes.  Upon  termination  of  the  monitor,  the  resource  usage  of  all 
activities  known  to  the  allocator  vill  be  reported,  including  system 
jobs.  This  output  follows  a  full  line  of  asterisks  to  denote  that  no 
termination  records  were  found  for  these  activities. 
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COLLECTED  ON  SYSTEM  NMCC2  ON  80-12-15  AT  TIME  12:19 

ACTIVITY  RESOURCE  USAGE  REPORT  -  REPORTED  PER  ACT  SIZE  ELAPSED  SIZE  WASTED  TIME(.l  SEC)  SPENT  IN 

SNUMB-ACT  CPU  &  10  TIME  (MS)  SIZE-TIME  PROD  MIN  MAX  TIME  CHANCE  CORE  SWAPS  MOVES  ALLOC  SWAP  MEMORY  GEWAKE 
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Figure  6-15.  Activity  Resource  Usuge  Report 
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In  both  this  report  and  the  following  report,  two  special  SNUMBs  may 
appear.  These  SNUMBs  are  WAKE  and  WAITL.  These  SNUMBs  will  appear 
for  any  activity  that  was  in  GWAKE  or  waiting  original  core  allocation 
during  the  entire  monitoring  session.  Due  to  the  manner  in  which  the 
data  collector  determines  the  SNUMB  of  a  job,  the  real  SNUMBs  are  not 
known  for  activities  in  either  of  the  above  categories. 

6.3.5  SNUMB- IDENT  Report.  The  SNUMB- IDENT  Report  is  used  to  correlate 
the  SNUMB,  IDENT,  and  USERID  of  an  activity.  This  allows  operations 
personnel  to  identify  each  job  reported  in  the  Memory  Map  and  Activity 
usage  Reports  with  a  particular  user  (see  figure  6-16). 

The  report  displays  the  SNUMB,  activity  number,  as  well  as  the  $IDENT  and 
SUSERID  cards  supplied  at  run  time.  The  report  also  supplies  the  start 
and  stop  times  of  the  activity.  At  the  far  end  of  an  entry  the  type 
function  being  performed  by  an  activity  (i.e. ,  GELOAD,  FILSYS,  COBOL, 
FORTY,  etc...)  is  also  presented. 

As  each  activity  terminates,  its  entry  is  made  to  this  report.  Upon 
termination  of  the  monitor,  a  summary  of  each  activity  still  being 
processed  at  monitor  termination  will  be  given  below  a  line  of  asterisks. 
These  activities  will  include  the  system  jobs  and  will  provide  an  indi¬ 
cation  of  system  costs, 

6.3.6  Memory  Map  Report.  The  Memory  Map  Report  supplies  a  complete 
mapping  of  memory  allocation.  Memory  is  broken  down  into  128K  half¬ 
quadrant  sections  and  is  displayed  as  such.  This  report  can  produce 
a  tremendous  quantity  of  data.  Users  should  consider  using  time 
intervals  any  time  the  Memory  Map  is  to  be  produced. 

Total  memory  can  be  pictured  by  laying  each  half  quadrant  side  by  side, 
with  a  time  correlation  being  made  by  using  the  page  and  line  numbers 
supplied  on  each  output.  The  output  is  lined  up  by  matching  page  numbers 
and  quadrant  numbers.  The  absolute  clock  time  for  each  quadrant  is  found 
on  the  map  of  the  first  half  quadrant  of  the  system  (0  to  128K).  (Refer 
to  figure  6-17). 

The  first  half  quadrant  shows  the  time  the  state  was  present,  the  time 
since  the  last  state  change,  and  the  memory  used  by  the  Hard  Core  Modules 
(HCM).  The  HCM  usage  is  shown  via  a  ****HCM***  character  string. 

The  remaining  space  and  all  other  half  quadrants  display  the  allocation 
of  memory  per  job  activity.  All  memory  allocated  is  shown  and  the  format 
is  as  follows: 


* - J0B0L-XX - * 

with  the  left  and  right  asterisks  representing  the  upper  and  lower 
addresses  of  the  job  whose  SNUMB  is  J0B0L,  with  an  activity  number  of 
XX.  Each  character  displayed  for  a  job  (from  and  including  the  aster¬ 
isks)  represents  IK  of  memory.  As  a  job  size  decreases,  the  format 
changes  as  follows: 
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SNUMB-IDENT  REPORT  COLLECTED  ON  SYSTEM  NMCC2  ON  80-12-15  AT  TIME  12:39 
SNUMB  START  STOP  USERID  IDENT 

8437T-  2  18:21  18:27  DJ3JC32406  1820020/30/4641  .TEST  ESET  UELOAD 
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FIGUUl  6-17 .  Memory  Map  Report 
(Part  1  of  3) 
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FIGURE  6-17.  (Part 


* - J0B01-XXX — * 


*J0B02-XXX— 

*J0B03* 

J0B04 

MM 


(16K)  including  SSAs 

(12K) 

(7K)  -  activity  discarded 
(5K)  -  asterisks  discarded 
(4K)  -  no  identification 


As  can  be  seen  in  figure  6-L7,  Part  1,  every  line  of  the  figure  has  a 
line  nunber  ranging  from  1-50.  In  addition,  there  is  a  page  number  in 
the  upper  right  corner.  When  the  user  wants  to  match  this  picture  of 
the  first  half  of  the  first  quadrant  with  its  corresponding  half  of  some 
other  quadrant,  the  following  steps  should  be  followed: 

1-  Match  page  numbers  (see  figure  6-17,  Part  2,  Part  3) 

2-  Match  the  line  numbers  from  identical  page  numbers. 


Two  special  names  can  appear  in  the  memory  map.  If  SSA  cache  memory  is 
configured  the  following  letters  will  be  found  in  the  map,  depending  on 
the  size  of  the  SSA  cache  memory: 


*SSA  CACHE** 
*SSA  CACHE 
*SSA  CAC 
SSA  C 


12K 

10K 

8K 

5K  (see  figure  6-17  Part  3) 


If  memory  has  been  released  from  the  system  then  the  letters  *-R£LEASED* 
will  appear  in  r'ie  du-~.  This  will  be  repeated  depending  upon  how  much 
memory  has  been  released. 

6.3.7  Demand  List  Report.  The  Demand  List  Report  shows  the  memory 
demand  outstanding  for  each  memory  state  displayed  on  the  memory  map. 

The  correlation  is  made  using  the  same  line  numbers  as  the  half  quadrants 
of  the  maps  themselves  (refer  to  figure  6-18). 

The  Demand  List  Report  shows  the  total  memory  available,  the  number  of 
jobs  waiting  memory,  the  demand  request  sizes  for  each  job  waiting 
memory.  The  memory  available  is  the  sum  of  all  holes  in  memory. 

6.3.8  Activity  Abort  Report.  This  report  Is  directly  related  to  the 
Activity  Resource  Osage  Report.  This  report  is  produced  whenever  the 
Activity  Report  is  produced.  For  every  activity  that  aborts  during  the 
monitoring  session,  an  entry  is  made  to  this  report.  The  entry  gives 
the  SNUMB,  Activity  Number,  Abort  Code,  CPU  Time,  Run  Hours,  USERID, 
and  ID ENT  for  the  activity. 


The  Abort  Code  is  either  an  octal  number  or  an  alphanumeric  value. 
The  meaning  of  these  codes  can  be  found  in  Appendix  A  of  Honeywell 
Manual  DD19  (GCOS). 
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Figure  6-18.  Demand  List  Report 


The  CPU  time  Is  the  amount  of  CPU  time  in  milliseconds  used  by  this 
activity  prior  to  its  abort.  This  is  the  total  CPU  time,  generated 
during  monitoring  session. 

The  Run  Hours  is  the  amount  of  time  this  activity  has  been  known  to  the 
monitor  (see  figure  6-19). 

At  the  bottom  of  the  report,  the  percent  of  total  CPU  time,  total  I/O 
time,  and  total  Run  time  used  by  the  aborted  activities  is  given.  This 
percentage  does  not  include  any  system  jobs  (i.e.  ,  program  number  <*  14) 
or  any  selected  SNUMBs  processed  by  Action  Code  ABORT.  The  selected 
SNUMBs  are  listed  at  the  end  of  the  report. 

6.3.9  Jobs  Out  of  Core  Report.  This  report  gives  a  detailed  picture  of 
memory  demand  outstanding  for  each  memory  state  displayed  on  the  memory 
map.  The  correlation  is  again  made  by  matching  the  page  nunfcers,  line 
numbers,  and  times  of  day  (see  figure  6-20).  If  a  line  number  does  not 
appear,  no  jobs  were  out  of  memory.  If  a  line  number  appears  more  than 
once,  more  than  two  Jobs  were  out  of  memory  at  that  time.  For  each  line, 
the  report  presents  the  following: 

o  Line  number  (always  SO  if  out  of  core  report  is  run  without 
memory  map) 

o  SNUMB  and  activity  number  of  job  waiting  memory 
o  Memory  demand  and  urgency 

o  Whether  the  job  could  fit  in  memory  if  available  memory  were 
compacted  (FWC) 

o  Whether  it  could  fit  into  an  existing  hole  of  memory  (FWOC) 

o  Whether  the  job  is  a  new  request  (NEW) ,  a  swapped  job  (SWAP) , 

or  a  job  GEWAKE  (GWKE) 

o  How  many  attempts  have  been  made  by  the  Core  Allocator  to  place 
this  job  into  memory 

It  is  also  possible  for  a  page  number  to  be  repeated.  This  occurs 
because  the  memory  map  prints  50  lines  per  page.  Since  the  Out  of  Core 
Report  can  print  several  lines  for  each  memory  map  line,  it  might  be 
necessary  to  use  several  pages  for  each  memory  map  page. 

This  report  can  produce  a  tremendous  amount  of  output.  Users  should 
consider  using  the  time  interval  option  if  this  report  is  needed. 

6.3.10  Excessive  Resource  Use  Report.  This  report  is  directly  related 
to  the  Activity  Resource  Usage  Report.  For  every  activity  that  is 
apparently  using  more  than  a  preset  amount  of  specified  resources 

(Wasted  Memory,  Memory  Used,  I/O  Secs,  CPU  Secs,  Ratio),  an  entry  is  made 
to  this  report.  The  user  must  realize  the  Wasted  Memory  column  is  not 
an  absolute  statement  that  a  user  is  wasting  memory.  Rather,  it  is  a 
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FIGURE  6-20.  Jobs  out  of  Core  Report 


statement  that  the  $LIMITS  card  appears  to  be  requesting  more  memory 
than  is  actually  required  by  this  job.  The  user  should  be  questioned 
in  order  to  determine  if  this  is  in  fact  true.  In  the  Honeywell  System, 
a  user  will  receive  whatever  amount  of  memory  renuested  on  the  SLIMITS 
card,  whether  or  not  the  amount  of  memory  is  actually  needed.  The  Ratio 
column  shows  the  ratio  of  the  total  elapsed  time  for  an  activity  divided 
by  the  total  memory  time  for  the  activity.  This  value  gives  an  indica¬ 
tion  of  the  activity  lengthening  factor;  i.e..  how  run  time  is  affected 
by  resource  cont ent ion . For  those  activities  using  excessive  memory  the 
report  also  indicates  the  amount  of  time  the  activitv  was  in  memory. 

The  default  values  for  an  entry  being  made  to  this  report  are  listed 
in  table  6-4.  These  values  can  be  changed  via  a  previously  described 
input  option.  This  report  will  be  produced  whenever  t he  Activity  Resource 
Report  is  produced  and  will  be  turned  off  whenever  the  Activity  Resource 
Report  is  off  (see  figure  6-21). 

6.3.11  Peripheral  Allocation  Status  Report.  This  report  will  track  an 
activity  as  it  proceeds  through  different  phases  of  Peripheral  Allocation. 
The  report  will  list  the  SNUMB-Act ivity  ,  amount  of  memory  the  activity 
will  require,  its  current  status,  the  time  it  entered  that  phase  of  allo¬ 
cation,  the  time  it  completed  that  phase  of  allocation,  the  total  time 
spent  in  a  given  phase  of  allocation,  the  device  type  it  is  waiting  for 
and  the  number  of  devices  the  activity  is  waiting  for.  Due  to  the  manner 
in  which  data  is  collected  for  this  report,  it  is  possible  that  certain 
phases  of  allocation  will  be  missed,  especially  if  that  phase  of  alloca¬ 
tion  occurs  within  a  short  time  span.  This  report  will  give  a  good 
indication  of  how  long  it  is  taking  activites  to  pass  through  the  Peri¬ 
pheral  Allocation  process.  Following  is  a  list  of  the  more  common 
phases  of  peripheral  allocation  and  their  meanings: 

New  Act  -  Activity  has  just  entered  the  Peripheral  Allocator 

Wait  Media  -  Activity  is  waiting  for  a  device 

Wait  Mnt  -  Activity  is  waiting  for  a  patch  or  tape  to  be  mounted 

Core  Queue  Full  -  Activity  has  been  completely  processed  and  is 

waiting  for  the  Peripheral  Allocator  to  send  the 
job  to  the  core  allocator 

Alloc  Done  -  Activity  has  been  sent  to  core  allocator.  For  this 

case  the  stop  time  and  total  time  columns  have  no  real 
meaning.  These  columns  simply  are  reporting  the  amount 
of  time  it  took,  the  monitor  to  realize  that  the  activity 
had  reached  the  core  allocator 

LIMBO  -  Activity  is  in  Limbo  and  has  not  even  been  granted  permis¬ 
sion  to  run 

HOLD  -  Activity  is  in  Hold  and  has  not  even  been  given  permission 
to  run 

Oily  activities  found  to  be  in  a  PALC  state  for  more  than  600  seconds  will 
he  reported.  This  limit  can  be  changed  by  using  the  PALC  input  option. 

See  figure  6-22  for  a  sample  of  this  report. 

6.3.12  Plot  Reports.  Three  different  plot  reports  are  produced  by  the 
data  reduction  program.  All  plots  are  produced  under  IQ-minute  intervals, 
where  the  interval  can  be  modified  by  the  user.  At  every  allocator  call 
the  various  parameters  to  the  plots  are  accumulated  and  every  10  minutes 
the  accumulated  parameters  are  averaged  and  an  average  value  is  output 
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PERIPHERAL  ALLOCATION  STATUS  REPORT 


Figure  6-22.  Peripheral  Allocation  Status  Report 


co  che  ploc.  Every  lOch  oucpuc  will  also  display  che  presenc  time  of 
day.  Each  horizoncal  posicion  has  a  delca  value,  which  is  princed  on 
che  ploc.  The  delca  value  is  computed  from  che  following  formula: 

(Upper  Ploc  Limic  -  Lower  Ploc  Limic) 

126 

The  ploc  limics  can  be  sec  by  che  user,  wich  che  defaulc  values  shown  in 
cable  6-3.  If  a  plocced  variable  is  beyond  or  on  an  axis  limic.  ic  will 
be  posicioned  ac  che  axis  limit.  If  any  2  points  coincide,  the  posi¬ 
cion  of  coincidence  will  be  marked  wich  a  2.  If  3  points  coincide, 
the  position  of  coincidence  will  be  marked  with  a  3.  (See  figure  6-23). 
The  end  of  the  plot  will  contain  a  summary  of  the  minimum  and  maximum 
values  of  each  curve. 

In  figure  6-23  we  see  Chat  chere  was  no  memory  shortfall  ac  all  (points 
A  &  B  are  coinciding  wich  the  left  axis;  i.e.,  a  2  is  output).  At  14:31 
both  curves  continue  to  coincide,  but  there  is  now  a  shortfall  of  36R 
(12th  point  times  delta  of  3).  At  14:41  the  memory  shortfall  of  the  CALC 
increased  to  75K  but  the  memory  shortfall  of  the  CALC  plus  the  PALC 
queue  increased  to  99K. 

In  order  to  obtain  a  continuous  curve  from  the  plots  the  user  needs  only 
to  connect  the  corresponding  letter  points  (see  figure  6-23). 

6.3.12.1  Plot  1  -  Available  Memory  vs.  Outstanding  Demand  in  Core 
Allocator  Queue  vs.  Outstanding  Demand  in  Core  Allocator  Queue  + 
Peripheral  Allocator  Queue.  This  three  parameter  plot  provides  an 
overview  of  the  time  dependence  of  both  the  system  load  and  memory 
availability.  It  can  aid  in  better  balancing  the  workload  across  the 
day  and  in  determining  when  memory  shortfalls  or  surpluses  exist.  The 
addition  of  memory  demand,  waiting  in  the  Peripheral  Allocator,  is  an 
attempt  to  give  a  truer  picture  of  how  much  additional  memory  could  be 
properly  utilized,  if  available.  As  long  as  the  B  and  C  points  fall  to 
the  left  of  the  A  points,  a  memory  surplus  exists.  If  the  B  and  C  points 
fall  to  the  right  of  the  A  points,  a  memory  shortfall  is  present. 

6.3.12.2  Plot  2  -  Memory  Shortfall  in  Core  Allocator  vs.  Memory  Short¬ 
fall  in  Core  Allocator  +  Peripheral  Allocator.  This  plot  is  obtained 
from  the  previous  plot  by  simply  calculating  the  actual  shortfall  and 
plotting  the  shortfall  points. 

6.3.12.3  Plot  3  -  Number  of  Activities  in  Core  Queue  vs.  Number  of 
Activities  in  Peripheral  Allocator  Queue.  In  this  plot  the  number  of 
activities  being  delayed,  instead  of  their  memory  demand,  is  plotted. 

6.3.12.U  Plot  4  -  Average  Size  of  TSS,  FTS,  NCP.  This  plot  displays 
the  average  size  of  TSS,  FTS  and  NCP  as  they  change  their  demand  for 
memory  over  time.  These  three  programs  whose  memory  demand  would  sig¬ 
nificantly  change  over  time.  The  FTS  and  NPC  programs  are  part  of  the 
WIN  subsystem. 
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Figure  6-23,  Standard  Plot 


6.3.13  Memory  Statistics  Report.  This  report  is  produced  after  the 
histograms.  It  details  all  the  information  needed  to  start  a  system 
analysis  as  detailed  in  section  14.  The  report  is  shown  in  figure  6-24 . 

The  values  for  this  report  are  obtained  as  described  in  section  14.6.3. 

6.3.14  Special  Job  Memory  Reports.  This  report  details  the  memory 
demands  made  by  a  series  of  Jobs  specially  requested  by  the  analyst  (see 
SPECL  option).  Figures  6-25  and  6-26  display  the  format  for  these  reports. 

Figure  6-25  displays  the  Memory  Demand  Report.  Every  time  a  specially 
requested  Job  issues  a  MME  GEMORE  for  memory  or  is  swapped  out/into 
memory,  an  entry  is  made  to  this  report.  In  figure  6-25,  we  see  that 
FTS  issued  a  GEMORE  for  5K  of  memory  at  1417  hours.  At  the  time  of  the 
MME  GEMORE,  FTS  was  at  50K.  The  -99999  in  the  Time  to  Satisfy  column 
indicates  that  this  was  the  time  when  the  GEMORE  was  issued.  As  can  be 
seen,  the  GEMORE  was  satisfied  at  l4l8  after  a  wait  of  72.5  seconds  and 
FTS  has  grown  to  55K.  At  1420,  FTS  issued  another  GEMORE.  Its  current 
size  is  only  33K  which  implies  that  between  lHl8  and  1420,  FTS  must  have 
released  17K  of  memory.  At  1421,  after  68.5  seconds,  the  GEMORE  was  satis¬ 
fied.  However,  it  should  be  noticed  that  the  size  of  FTS  has  not  changed. 

In  addition,  the  next  entry  seen  for  FTS  is  a  SWAP  with  a  memory  demand  of 
40K.  This  series  of  events  implies  that  at  1420,  FTS  issued  a  GEMORE  for 
2K  of  memory  and  the  system  was  required  to  SWAP  FTS  from  memory  before  this 
demand  could  be  satisfied.  Therefore,  it  actually  took  a  total  of 
(68.5+3.8)  seconds  before  the  2K  memory  request  was  satisfied. 

In  figure  6-2 6,  the  second  of  the  Special  Memory  Reports  is  displayed.  An 
entry  in  this  report  is  made  under  the  same  time  interval  constraints  as 
the  various  memory  plot.  The  report  shows  the  average  size  cf  the  specially 
requested  jobs  over  the  respective  time  intervals. 

6.4  Error  Messages 

All  error  messages  are  self-explanatory  or  else  followed  by  the  words 
"For  Information  Only."  In  this  case,  the  message  can  be  ignored  and 
processing  will  continue,  without  error. 
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6- 5  Multireel  Processing 

If  more  than  a  single  reel  of  data  has  been  collected,  a  series  of 
messages  will  be  printed  at  the  computer  console  informing  the  operator 
that  a  new  data  reel  Is  required.  The  following  are  the  messages  produced. 

a.  DISMOUNT  REEL  #XXXXX  THEN  MOUNT  REEL  NUMBER  YYYYY  ON  ZZZZZ 

In  this  case,  XXXXX  Is  the  old  reel  number,  YYYYY  Is  the  new  reel 
number,  and  ZZZZZ  is  the  tape  drive  ID. 

If  the  operator  fails  to  mount  the  new  tape,  the  above  message 
will  be  repeated  three  times,  after  which  the  program  will 
terminate,  and  all  reports  will  be  produced. 

b.  IS  TAPE  XXXXX  MOUNTED  ON  DRIVE  ID  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  tape  number  being  requested  and  YYYYY 
is  the  appropriate  tape  drive  ID. 

This  message  occurs  when  the  data  reduction  program  finds  the 
wrong  tape  has  been  mounted  (by  comparing  internally  generated 
tape  labels).  If  the  operator  answers  N,  the  message  in  (c) 
below  is  produced.  If  the  operator  answers  Y,  the  data  reduction 
program  will  terminate  and  all  reports  will  be  produced.  In  this 
case,  the  data  reduction  program  is  unable  to  process  the  tape. 
Even  though  the  operator  is  mounting  the  correct  tape,  the 
internal  label  on  the  new  tape  does  not  match  that  being 
requested  by  the  old  tape.  The  user  should  check  the  data 
collection  session  to  insure  that  the  operator  did  not  respond 
with  an  incorrect  tape  number  during  multireel  change. 

After  entering  the  Y  or  N,  the  operator  will  need  to  hit  the  EOM 
key  twice  in  order  for  the  response  to  be  transmitted. 

c.  WRONG  REEL  JUST  MOUNTED,  DISMOUNT  AND  MOUNT  REEL  XXXXX  ON  ZZZZZ 

In  this  case,  XXXXX  is  the  new  reel  number,  and  ZZZZZ  is  the  tape 
drive  ID. 

d.  CAN  TAPE  XXXXX  BE  MOUNTED  ON  DRIVE  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  new  desired  reel  and  YYYYY  is  the  tape 
drive  ID. 

If  the  operator  fails  to- answer  this  message,  it  will  be  repeated 
until  he  responds  with  a  "Y"  for  YES  or  "N"  for  NO.  If  he  types 
in  ”Y" ,  then  message  (a)  will  be  repeated.  If  he  types  in  "N”, 
then  the  program  will  be  terminated  and  all  reports  will  be 
produced . 
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6.6  Tape  Error  Aborts 


During  the  course  of  processing,  it  is  possible  that  the  operator  will  be 
required  to  abort  the  data  reduction  program  due  to  an  irrecoverable  tape 
error.  If  such  a  condition  occurs,  the  operator  should  abort  this  job 
with  a  "U“  abort.  This  will  allow  the  data  reduction  program  to  enter  its 
wrap-up  code  processing  and  produce  all  reports  generated  prior  to  the 
tape  error. 
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SECTION  7.  MASS  STORE  MONITOR  DATA  REDUCTION  PROGRAM  ( MSMDRP ) 


7.1  Introduction 

The  Mass  Store  Monitor  Data  Reduction  Program  is  a  FORTRAN  program  that 
sequentially  processes  data  the  Mass  Store  Monitor  collected  and  wrote  on 
tape.  MSMDRP  produces  a  number  of  reports  depicting  the  physical  and 
logical  usage  of  the  mass  storage  subsystem  during  the  monitoring  period. 

A  list  of  these  reports  is  found  in  table  7-1  and  report  descriptions  are 
presented  in  subsection  7.5. 

The  Mass  Store  Monitor  and  its  Data  Reduction  Program  were  conceived  as  a 
response  to  the  need  for  information  on  the  rate  and  characteristics  of 
usage  of  mass  store  subsystems.  The  information  collected  is  applicable  in 
the  following  areas: 

o  Discovery  of  improper  configurations  (software  or  hardware),  e.g., 
not  alternating  usage  of  dual  physical  channels  configured  on  a 
subsystem. 

o  Discovery  of  improper  device  utilization,  e.g.,  use  of  only  a  small 
number  of  the  devices  configured  instead  of  having  the  activity 
spread  over  all  configured  devices. 

o  Discovery  of  open  file  allocation  on  a  device  which  can  cause  long 
and  frequent  am  movement. 

o  Identification  of  files  (either  system  or  user  data  base)  which  are 
frequently  accessed  and  quantification  of  the  rates  of  access  to 
them. 

There  are  two  inputs  to  the  MSMDRP.  The  first  is  the  data  tape  produced  by 
the  MSM  in  the  General  Monitor  Collector.  The  second  input  is  a  set  of 
report  option  control  cards  used  to  alter  the  reports  in  some  way  other 
than  the  standard  default.  The  various  user  input  options  and  their 
formats  are  described  in  subsection  7.6.  The  actual  reports  produced  by 
the  MSMDRP  are  described  in  subsection  7.5. 

The  Mass  Store  Monitor  Data  Reduction  Reports  can  be  used  to  assist  the 
analyst  in  applying  models  In  the  area  of  system  performance  evaluation  by 
providing  computer  system  resource  usage  information  in  a  format  conducive 
to  defining  the  system  workload.  Models  of  computing  systems  are 
frequently  used  to  evaluate  configurations  which  are  not  currently 
available  or  are  perhaps  unrealized.  The  usefulness  of  this  type  of  model 
depends  upon  two  basic  characteristics:  (1)  how  faithfully  the  model 
represents  the  operation  of  the  system  being  modeled,  and  (2)  how 
faithfully  the  input  parameters  to  the  model  represent  the  workload  to  be 
placed  on  the  system.  MSM  and  MSMDRP  are  key  contributors  to  such  model 
development. 
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Table  7-1.  MSM/MSMDRP  Reports 


1  System  Configuration  and  Channel  Usage  Report  (File  42) 

2  System  Summary  Report  (File  42) 

3  System  Traces  Captured  by  Monitor  Report  (File  42) 

4  Channel  Status  Changes  Report  (File  29) 

5  Physical  Device,  Device  ID  Correlation  Table  Report  (File  42) 

6  Device  Space  Utilization  Report  (File  42) 

7  Device  Seek  Movement  Report  (File  42) 

8  Head  Movement  Efficiency  Report  (File  42) 

9  System  File  Use  Summary  Report  (File  21)  (NAME=SYSFILES ) 

10  Individual  Module  Activity  Report  (File  21)  ( NAME *SYSF ILFS) 

11  SSA  Module  Usage  Report  by  Job  (File  21) 

12  File  Code  Summary  Report  (File  23)  (NAME=FILEC0DE) 

13  CAT/File  String  Report  (File  23) 

14  Connect  Summary  Report  by  'Iserid/SNUMB  (File  23) 

15  Activity  Summary  Report  (File  24)  {NATC*ACTIVITY) 

16  Device  Area  File  Code  Reference  Report  (File  22)  (NAME*AREA) 

17  Device  File  Use  Summary  Report  (File  21)  (NAME=FILEUSE) 

18  Chronological  Device  Utilization  Report  (File  26)  (NAME-CHR0N0) 

19  FMS  Cache  Report  (File  21) 

20  Connects  Per  10  Minute  Report  (File  20)  (NAME»RATE) 

21  Proportionate  Device  Utilization  Report  (File  42) 

22  Elapsed  Time  Between  Seeks  Report  (File  42) 

23  Data  Transfer  Size  Report  (File  42) 

24  Number  of  OCWs  Per  Connect  Report  (File  42) 
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7.2  Data  Collection  Methodology 


The  MSM  in  the  General  Moni tor  Collector  processes  GCOS  trace  types  7  and 
15  and  collects  information  to  monitor  the  usage  of  the  entire  disk 
subsystem.  The  information  collected  on  the  occurrence  of  the  above  traces 
enables  the  MSMDRP  to  identify  the  activity  issuing  the  I/O  request,  the 
file  being  accessed,  the  disk  pack  upon  which  the  file  is  located,  arm 
movement  required  in  order  to  accomplish  the  requested  file  accessing,  and 
the  type  of  accessing  being  requested;  e.g.,  read,  write,  write  verify,  etc. 

If  the  system  being  monitored  by  the  MSM  is  configured  with  SSA  Cache  Core, 
the  MSM  will  create  two  direct  transfer  traces  (types  73  and  76)  in  order 
to  collect  data  to  analyze  the  effectiveness  of  SSA  Cache  Core.  The  method 
for  generating  these  new  direct  transfer  traces  is  described  in  subsection 
5.2.2,  and  the  formats  for  the  MSM  generated  records  used  by  the  MSMDRP  are 
described  in  subsection  5.4.3. 

Finally,  if  the  system  being  monitored  by  the  MSM  is  configured  with  FWS 
Catalog  Cache,  a  data  record  is  generated  so  that  the  MSMDRP  can  report  on 
the  effectiveness  of  FMS  Catalog  Cache. 

7,3  Analytical  Methodology 

An  evaluation  of  the  Mass  Storage  Subsystem  reports  produced  by  the  MSMDRP 
requires  concurrent  use  of  the  reports  produced  by  the  Channel  Monitor  Data 
Reduction  Program  (CMDRP).  Chapter  14  provides  a  detailed  description  of 
the  procedure  to  be  followed  in  such  an  evaluation.  Subsection  8.3 
provides  a  detailed  description  of  the  entire  I/O  process,  and  the  traces 
generated  during  the  processing  of  an  I/O  request.  In  general,  the  CMDRP 
is  used  to  identify  channels  and/or  devices  which  are  acting  as  bottlenecks 
to  the  efficient  operation  of  the  system,  while  the  MSMDRP  reports  are  used 
to  determine  the  exact  activities,  files,  and  file  codes  that  are  causing 
the  contention  uncovered  by  the  CMDRP  reports.  The  MSMDRP  reports  will 
also  identify  those  devices  experiencing  seek  elongation  problems  and  the 
files  upon  these  devices  which  are  responsible  for  the  seek  elongation. 
Finally,  the  MSMDRP  reports  will  identify  those  files  that  are  candidates 
for  device  relocation  or  placement  into  Hard  Core  or  SSA  Cache  Buffer  space. 

Before  a  user  conducts  a  Mass  Storage  Subsystem  Evaluation,  it  is  important 
to  have  an  understanding  of  the  entire  I/O  process.  Subsection  8.3 
provides  a  detailed  description  of  the  entire  I/O  process  and  all  traces 
generated  during  the  processing  of  an  I/O  request.  In  this  subsection,  a 
description  of  only  the  connect  (trace  type  7)  event  will  be  presented. 

Each  time  a  system  program  or  application  program  issues  an  I/O  request 
(read  disk/tape,  write  disk/tape,  seek,  etc.  .  . )  the  GCOS  system  will 
generate  a  trace  type  7  (connect  event).  Upon  the  occurrence  of  this 
event,  several  internal  tables  are  updated  and  it  is  these  tables  that  the 
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MSM  references  in  order  to  generate  its  data  record.  A  program’s  SSA  area 
contains  tables  for  the  Peripheral  Assignment  Table  (PAT)  and  the  PAT 
Pointer.  These  are  used  to  describe  the  device  and  space  allocation  for  a 
particular  file  and  the  file  code  to  correlate  a  user  file  code  to  the  PAT 
and  the  device  on  which  that  file  is  allocated.  The  .CRIO  and  .CRCT  tables 
contain  descriptive  information  concerning  device  and  channel 
configuration.  Finally,  the  program's  SSA  area  also  contains  an  area  which 
is  used  for  I/O  entries.  These  entries  are  each  11  words  long  and  contain 
detailed  information  concerning  the  I/O  just  requested.  They  are  referred 
to  as  the  11  word  I/O  queue  entry. 

I/O  requests  can  be  of  tv/o  types  (single  or  nul ticomnand ) .  Mul  ticormands 
are  of  the  type  seek -read,  seek -write,  or  seek -write  verify.  Single 
commands  can  be  status  requests  of  certain  types,  or  reads/writes,  where 
seeks  are  not  required.  These  different  types  of  I/O  connands  are 
processed  and  reported  in  different  fashions  by  the  various  MSMDRP  reports 
(see  individual  output  reports).  Finally,  whenever  the  system  generates  a 
multi  I/O  coimand,  it  is  necessary  for  the  system  to  record  the  actual  seek 
address  being  requested,  normally,  this  seek  address  is  stored  in  I/O 
queue  word  number  4.  Whenever  the  MSM  processes  a  nul ticomand,  it  expects 
to  find  a  valid  seek  address  at  this  location.  However,  there  are  certain 
occurrences  v/hen  a  mul ticomnand  is  issued  and  I/O  queue  word  4  does  not 
contain  a  valid  seek_ address.  In  these  cases,  Bit  32  of  I/O  queue  word  2 
is  set  to  a  0.  The  Computer  Performance  Evaluation  Office  is  currently 
conducting  studies  to  determine  exactly  when  this  nonstandard  procedure 
occurs  and  if  there  is  any  manner  in  which  the  MSM  can  determine  the 
correct  seek  address.  Under  the  current  processing  procedures,  the  MSMDRP 
recognizes  the  seek  address  as  being  invalid  and  performs  certain  special 
processing  in  order  to  recover  from  this  event,  thereby  affecting  several 
of  the  output  reports  (see  individual  output  reports). 

7.4  Data  Reduction  Methodology 

The  MSMDRP  currently  uses  random  I/O  (File  58)  to  process  histogram  data 
for  the  Device  Space  Utilization  and  Device  Seek  Movement  reports.  This 
feature  allows  the  MSMDRP  to  process  an  unlimited  number  of  devices  with  a 
minor  Increase  in  memory  requirements.  As  delivered,  the  MSMDRP  will 
process  data  describing  75  mass  storage  devices  and  40  mass  storage 
channels.  It  will  produce  64  unique  histograms  with  no  random  I/O.  If  the 
number  of  channels  or  devices  is  insufficient,  the  user  will  need  to  edit 
file  B29IDPX0/S0URCE/MSM.  The  user  should  enter  the  edit  subsystem  and 
process  the  following  command: 

B  RS:/NRDEVXX=XX75/;*:/NRDEVXX =XX  new  number  of  devices/ 

B  RS:/NRCHANXX=XX40/;*:/NRCHANXX=XX  number  of  new  channels/ 

For  each  additional  device,  the  size  of  the  program  will  increase  by  10 
words  and  for  each  additional  channel,  the  program  will  increase  by  45 
words.  For  the  above  edit,  the  character  "X"  signifies  a  space. 
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The  next  variable  that  will  need  to  be  changed  is  RPTCWT.  This  number 
represents  the  total  number  of  histograms  and  reports  that  will  be 
processed  v/i th  no  random  I/O.  To  calculate  the  value  required,  the 
following  formula  should  be  used. 

(number  of  devices  actually  configured)*2+8 

If  this  value  is  less  than  72  (32  disk  devices),  no  change  is  required.  If 
the  value  required  is  greater  than  72,  the  user  may  alter  this  value.  This 
will  help  to  limit  the  amount  of  random  I/O  being  performed  but  will 
increase  storage  by  80  words  for  each  increment  above  72.  This  trade-off 
between  CPU/ 10  time  and  memory  must  be  made  at  the  discretion  of  the  user. 
In  order  to  change  this  value,  the  following  edit  function  should  be 
performed: 

B  RS:/RPTCNTX=X72/;*:/RPTCNTX=Xnew  value/  (11  occurrences) 

As  in  the  earlier  edit  example,  the  character  "X"  should  not  be  typed,  but 
is  being  used  to  represent  a  blank  column. 

After  performing  the  above  edits,  the  user  should  recompile  the  source 
program  by  entering  the  card  subsystem  and  issuing  a  run  command. 

7.5  MSMDRP  Output 

The  MSMDRP  produces  a  series  of  24  reports  listed  in  table  7-1  over  which 
the  user  has  limited  control.  Those  eight  reports  with  a  NAME=codename 
designation  offer  greater  parameter  control  to  the  user.  This  parameter 
control  will  be  described  in  subsection  7.6.  In  table  7-1,  the  file  nn 
designation  indicates  the  file  code  used  to  record  the  given  report  and  is 
of  no  real  concern  to  the  user.  In  addition,  a  series  of  messages  are 
produced  which  supply  the  user  with  Information  concerning  special 
processing  events  that  occurred  during  the  execution  of  the  data  reduction 
program.  Most  of  these  processing  messages  are  for  Information  only,  and 
can  be  ignored.  The  following  subsections  will  describe  all  the  reports 
listed  in  table  7-1.  and  subsection  7.5.25  will  describe  the  processing 
messages  that  may  be  produced  during  the  course  of  data  reduction. 

7.5.1  System  Configuration  and  Channel  Usage  Report  (File  42).  This 
report  documents  the  system  identification,  configuration,  and  the  date  and 
time  of  the  monitoring  period,  as  well  as  reporting  the  usage  of  all 
configured  I/O  channels.  Figure  7-1  is  an  example  of  this  report.  The 
heading  line  Indicates  the  software  version  number  that  corresponds  to  this 
document.  The  version  number  should  be  01-82.  The  first  line  after  the 
heading  provides  the  tape  number(s)  the  report  was  generated  from,  the 
system  Identification,  the  date  (in  the  form  year,  month,  and  day  - 
YYMMDD ) ,  and  the  start  and  stop  times  (HH:MM:SS)  of  the  MONITORING 
SESSION.  The  next  several  lines  of  output  describe  the  overhead  of  all  GMF 
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Figure  7-1.  Systen  Configuration  and  Channel  Usage  Report 


monitors  that  were  active  during  data  collection.  The  monitor  name  is 
given,  its  CPU  time  in  seconds,  and  its  overhead  as  a  function  of  total 
processor  power.  The  GMF  executive  overhead  is  separated  from  the  actual 
monitors  and  is  listed  as  "EXEC".  The  monitor  "WAft"  is  an  area  of  code 
within  the  Mass  Store  Monitor  and  even  though  listed  separately  it  is  also 
included  under  the  monitor  "MSM“.  The  monitor  "FMS"  is  also  an  area  of 
code  within  the  Mass  Store  Monitor,  but  in  this  case  it  has  not  been 
included  under  the  monitor  "MSN". 

Monitor  “CM"  in  this  report  describes  the  processor  overhead  of  subroutine 
T4  (terminate  processing)  and  subroutine  T22  (start  I/O  processing). 

Monitor  "MSM"  in  this  report  describes  the  processor  overhead  of  subroutine 
T7  (connect  processing).  Therefore,  if  the  Channel  Monitor  wa s  active,  but 
the  Mass  Store  Monitor  was  not,  this  report  will  still  list  both  "CM"  and 
"MSM"  as  contributing  to  the  processor  overhead.  The  total  Channel  Monitor 
overhead  will  be  found  by  adding  the  overhead  of  the  "CM"  monitor  to  the 
overhead  of  the  "MSM"  monitor,  to  the  overhead  of  the  "FMS"  monitor. 

If  both  the  Channel  Monitor  and  Mass  Store  Monitor  were  active,  then  the 
combined  overhead  of  both  monitors  can  be  found  as  the  sum  of  "MSM"  +  “CM" 

+  "FMS". 

For  purposes  of  this  report,  %  overhead  is  computed  as: 

(CPUTIME  Used  by  Monitor) _ 

(TOTAL  Elapsed  YimeTxf Number  of  Processors) 

Following  the  overhead  description  are  three  lines  of  configuration 
information  describing  the  number  of  processors,  IOMs,  and  amount  of  memory 
configured  to  the  system.  In  adcic:n,  the  sice  of  GCOS  Hard  Core,  the 
size  of  the  Core  Allocator  and  the  size  of  FILSYS  is  also  presented.  The 
third  line  of  the  configuration  data  indicates  the  number  of  processors 
actually  configured  and  actually  available.  These  numbers  might  be 
different  than  shown  on  the  first  line  due  to  the  assigning  and  releasing 
of  processors.  In  figure  7-1,  we  see  that  one  processor  was  released  for  a 
period  of  time  (i.e.,  CPUs  actually  available  is  equal  to  1.75).  The 
actual  time  that  processors  were  available  or  released  is  indicated  in  the 
status  message  printouts  (see  subsection  7.5.25). 

The  next  portion  of  the  report  documents  the  channel  configuration  by  IOM, 
listing  each  configured  channel  number,  the  device  type  configured  to  that 
channel,  and  the  channel  crossbarring.  The  crossbar  column  shows  those 
channels  that  are  crossbarred  to  the  channel  identified  under  the  channel 
column.  If  SEE  ABOVE  is  found,  the  crossbarring  has  been  displayed  on  a 
preceding  channel.  The  I-CC  format  of  each  channel  description  identifies 
the  IOM  and  the  channel  number  being  discussed.  The  last  column  of  this 
report  displays  the  number  of  all  connect  types  issued  over  that  channel. 
This  section  will  be  repeated  for  each  IOM  configured  to  the  system. 

Figure  7-1  only  displays  IOM  0  activity.  This  report  is  always  generated 
and  cannot  be  turned  off. 
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Figure  7-2.  MSM  System  Summary  Report 


7.5.2  System  Surmary  Report  (File  42).  The  Sytem  Configuration  and 
Channel  Usage  Report  and  the  System  Sumary  Report  may  be  used  to  assess 
overall  system  utilization.  Figure  7-2  is  an  example  of  the  System  Sumnary 
Report.  The  first  set  of  lines  shows  the  number  of  connects  to  the 
monitored  mass  storage  subsystems  compared  to  the  total  connects  issued 
(T APE+DISK )  and  the  connect  rate  per  hour  over  the  subsystem.  Most  systems 
will  show  a  small  number  of  Control  Connects  being  generated  by  the  MPCs 
configured  to  the  system.  These  Control  Connects  will  be  summed  together 
and  listed  as  a  separate  subsystem  line.  Analysis  on  a  Shared  Mass  Storage 
System  shows  the  number  of  fPC  connects  generated  to  be  a  significant 
percentage  of  the  total  connects  generated.  The  next  lines  show  the 
breakdown  of  the  mass  storage  connects  by  the  IOM  channel  over  which  they 
were  issued.  The  final  part  of  this  report  is  a  list  of  the  commands 
(octal  code  and  mnemonic)  issued  to  the  mass  storage  subsystem  and  the 
count  of  each  issued  during  the  monitoring  session.  This  report  is  always 
generated  and  cannot  be  turned  off. 

A  well  performing  system,  under  a  heavy  workload,  should  show  a  high 
utilization  of  the  configured  resources.  Figure  7-2  shows  that  the  I/O 
activity  is  predominantly  on  the  MSU45Q  subsystem  configured  on  channels  8 
and  9  of  IOM  0  and  1  (see  figure  7-1).  The  MSU450s  are  receiving  51"  of 
all  connects  and,  therefore,  should  be  the  major  area  of  concern.  The 
access  rate  for  every  subsystem  is  reported  on  the  top  of  the  System 
Sumnary  Report  and  it  can  be  seen  that  the  MSU450s  have  an  access  rate 
significantly  higher  than  the  other  subsystems.  All  signs  indicate  that  if 
system  throughput  is  being  affected  by  disk  activity,  then  the  MsU450s 
would  be  the  probable  cause  of  such  problems. 

The  next  item  to  check  on  these  two  reports  should  be  the  channel  usage. 

The  two  highest  used  logical  channels  of  any  subsystem  should  be  on  a 
separate  PSI  channel  of  a  two-PSI  channel  subsystem.  Referring  to  figure 
7-2,  one  can  see  that  logical  channel  8  of  IOM  0  and  IOM  1  has  the  highest 
usage,  and  this  is  the  proper  configuration.  If  the  highest  used  logical 
channels  are  not  on  separate  PSI  channels,  the  $  XBAR  card  in  the  startup 
configuration  section  is  suspected  as  the  cause.  The  channels  are  used  in 
the  order  given  on  the  $  XBAR  card  (i.e. ,  if  the  primary  channel  is  busy, 
the  next  channel  tried  is  given  on  the  crossbar).  The  alternate  use  of  PSI 
channels  for  maximum  simultaneity  must,  therefore,  be  appropriately 
specified  in  the  boot  deck. 

While  looking  at  the  System  Summary  Report,  it  is  also  of  interest  to  note 
the  ratio  of  READ  commands  to  WRITE  commands  (over  two  to  one  in  this 
example).  This  gives  an  indication  of  the  nature  of  the  usage  of  the  mass 
storage  space.  A  quick  look  at  the  number  of  write/verify  (WR-VER) 
commands  executed  is  also  of  interest  as  they  are  essentially  double 
(WRITE,  then  READ)  data  transfer  commands  which  require  more  device  and 
channel  time. 

The  general  fraction  of  utilization  for  each  logical  channel  gives  an 
indication  of  the  degree  of  simultaneity  of  access  to  the  subsystem.  If 
only  N  of  the  configured  logical  channels  have  nonzero  counts,  then  there 
were  never  more  than  N  accesses  being  performed  simultaneously  by  the 


subsystem.  The  proportional  relationships  among  the  counts  of  accesses 
made  over  each  of  the  logical  channels  are  quantitative  indications  of  the 
frequency  of  occurrence  of  specific  levels  of  simultaneity.  As  an  example, 
if  we  look  at  figure  7-2,  we  see  that  only  4487  connects  out  a  total  of 
107,273  connects  went  to  Channel  9,  IOH  1.  This  means  that  only  4487  times 
during  the  measuring  period  were  all  four  MSU450  disk  channels  being 
utilized  simultaneously.  In  this  example,  channel  queuing  (i.e.,  shortage 
of  channel  power)  would  not  appear  to  be  a  problem.  This  is  not  to  infer 
that  device  queuing  is  not  a  problem,  just  that  channel  queuing  does  not 
appear  to  be  a  problem.  If  the  number  of  accesses  to  the  lowest  priority 
channel  is  a  larger  percentage  of  the  total  accesses,  then  channel  queuing 
needs  to  be  examined.  Queuing  for  devices  and/or  channels  can  be  analyzed 
by  running  the  Channel  Monitor  Data  Reduction  Program  (see  section  8). 

7.5.3  System  Traces  Captured  by  Monitor  Report  (File  42).  This  report 
contains  the  number  of  occurrences  of  each  specific  trace  type  record  on 
the  data  collector  tape  processed  by  the  MSMDRP  (figure  7-3).  This  report 
provides  little,  if  any,  information  required  by  the  user  for  his 
analysis.  This  report  is  always  generated  and  cannot  be  turned  off. 

7.5.4  Channel  Status  Changes  Report  (File  29).  This  report  lists  the 
initial  status  for  all  tape  and  disk  channels  configured  to  the  system 
(figure  7-4).  If,  during  the  course  of  the  monitoring  session,  a  given 
channel  or  IOM  was  dropped  or  added  to  the  system  (dynamic  reconfiguration) 
a  new  report  will  be  produced  indicating  the  activation  of  deactivation 
changes  and  the  time  that  the  change  occurred.  Finally,  this  report  will 
indicate  whether  the  SSA  cache  option  and  FM$  cache  option  are  active,  and 
if  so,  will  indicate  their  initial  status  and  any  changes  that  occur  to 
that  status.  If  a  given  option  is  not  active,  a  zero  will  be  reported  for 
each  of  the  values.  This  report  is  always  generated  and  cannot  be  turned 
off. 

7.5.5  Physical  Device,  Device  ID  Correlation  Table  (File  42).  Each  mass 
storage  device  configured  in  the  system  is  listed  with  a  unique  device  ID. 

A  typical  report  is  presented  in  figure  7-5.  This  unique  device  is  needed 
since  different  devices  can  have  the  same  device  number  on  the  Honey\/ell 
6000.  (See  Device  ID  1,  Device  ID  7,  and  Device  ID  18  of  figure  7-5). 

These  unique  numbers  are  referenced  in  several  reports  produced  by  the 
MSMDRP.  This  report  is  always  generated  and  cannot  be  turned  off. 

7.5.6  Device  Space  Utilization  Report  (File  42).  The  device  space 
utilization  histogram  report  is  produced  for  every  device  on  the  mass 
storage  subsystem  and  shows  the  distribution  of  access  to  the  device 
space.  Figure  7-6  is  an  example.  It  should  be  noted  that  the  name  of  the 
device  Is  also  given.  This  example  presents  all  connects  made  to  the 
device  with  the  name  RF5.  If  an  exchange  took  place  and  the  RF5  disk  pack 
was  moved  from  0-08-05  to  0-08-01  the  data  reduction  program  will  account 
for  that  exchange  and  any  connects  that  are  made  to  0-08-01  will  be 
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THE  PHYSICAL  DEVICE,  DEVICE  ID  CORRELATION  TABLE 
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Figure  7-5.  Physical  Device,  Device  ID  Correlation  Table 
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reported  on  this  histogram  and  not  to  the  0-08-01  histogram.  Entries  in 
the  col iinn  headed  CYlflDR  NUMBER  give  the  range  of  cylinders  which  form  each 
h-'stogran  bucket.  The  number  of  cylinders  in  each  bucket  is  a  function  of 
the  device  type.  The  entries  in  the  column  headed  INDIV.  NUMBER  give  the 
number  of  accesses  made  to  that  device  within  the  physical  space  defined  by 
the  range  of  cylinders. 

Similarly,  the  columns  headed  INDIV.  PRC  and  CUMUL.  PRC  give  the  individual 
and  cumulative  percentages  of  all  accesses  to  that  dev-'ce  which  were  made 
within  each  cylinder  range.  The  graphic  portion  of  the  display  gives  a 
visual  indication  of  the  percentage  of  accesses  which  were  made  for  each 
range  of  the  device  space.  This  helps  to  quickly  assess  the  access  pattern 
of  the  usage  for  the  device,  i.e.,  whether  the  device  is  totally  allocated 
and  used  or  locally  used.  Figure  7-6  shows  a  device  whose  usage  is  split 
between  two  extremes.  Such  a  situation  should  be  investigated. 

In  the  upper  right  hand  corner  of  the  report,  a  report  number  is 
indicated.  This  report  number  is  used  only  to  distinguish  one  histogram 
from  another  and  in  no  way  indicates  the  device  to  which  the  report 
refers.  In  addition,  report  numbers  may  not  appear  sequentially  and  this, 
in  no  way,  is  indicative  of  a  problem.  This  report  is  always  generated  and 
cannot  be  turned  off. 

7.5.7  Device  Seek  Movement  Report  (File  42).  The  seek  movement  histogram 
is  produced  for  devices  in  the  mass  storage  subsystem  being  analyzed  and 
provides  the  distribution  of  distance  traveled  by  the  read  mechanism. 

Figure  7-7  is  an  example.  The  data  used  to  generate  this  report  is  the 
absolute  value  of  the  difference  between  the  cylinder  addresses  of  each 
successive  access  to  the  given  device.  The  column  headed  CYLNDR  MOVED 
contains  the  range  of  seek  movement  distance  for  each  line  of  the  report. 
The  column  headed  INDIV.  NUMBER  contains  the  counts  of  the  number  of 
accesses  which  caused  the  arm  to  be  moved  that  distance.  Figure  7-7  shows 
854  accesses  caused  no  arm  movement  (the  same  cylinder  was  successively 
accessed)  for  IOM-O  Device  05  on  PUB  8.  The  INDV.  PRC  and  CUMUL.  PRC 
columns  give  the  individual  and  cumulative  percentages  of  the  accesses  to 
that  device  which  resulted  in  a  particular  range  of  seek  movement. 

Figure  7-7  shows,  for  example,  that  263  (12.8  percent)  of  the  accesses 
caused  arm  movement  in  the  range  of  714  to  730  cylinders  and  that  1313 
(64.2  percent)  of  the  arm  movements  were  a  distance  of  16  cylinders  or 
less.  The  statistics  at  the  bottom  of  this  report  give  the 
characterization  of  the  seeking  characteristics  of  the  files  being  accessed 
on  this  device  during  the  monitoring  period.  The  minimum  movement,  maximum 
movement,  average,  variance,  and  standard  deviation  are  Included.  This 
report  is  always  generated  and  cannot  be  turned  off. 

The  Device  Space  Utilization  Report  (figure  7-6)  shows  that  most  of  the 
accessing  was  concentrated  in  two  areas  on  the  device  (cylinders  0-50  and 
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Figure  7-7.  Device  Seek  Movement  Report 


680-764).  This  is  not  necessarily  bad,  but  if  "interlaced”  accessing  was 
between  these  two  areas,  many  seeks  of  about  700  cylinders  would  result. 

If,  on  the  other  hand,  accessing  to  one  area  was  completed  before  accessing 
to  another  began,  there  would  be  no  large  number  of  movement  seeks.  In 
this  case,  the  example  in  figure  7-7  shows  18  percent  of  the  seeks  to  be 
across  a  distance  of  714-764  cylinders.  This  represents  a  situation  where 
the  particular  files  and  jobs  may  need  to  be  identified  so  that  methods  for 
reducing  the  number  of  movement  seeks  may  be  found  and  implemented  for 
performance  improvement.  Further  confirmation  of  this  problem  could  be 
found  by  analyzing  the  Head  Movement  Efficiency  Report  (see  subsection 
7.5.8  and  figure  7-8).  If  a  problem  exists  then  the  connects/am  movement 
column  for  this  particular  device  should  approach  a  value  of  one.  This 
figure  indicates  how  many  connects  are  issued  between  each  movement  of  the 
am.  Therefore,  even  though  we  may  have  long  seeks  occurring  on  the 
device,  if  a  large  number  of  connects  are  being  processed  between  these 
seeks,  this  would  tend  to  lessen  the  impact  of  the  long  seeks. 

For  the  Device  Space  Utilization  Report  and  Device  Seek  Movement  Report,  an 
entry  is  made  only  for  mul ti -command  connects  (see  subsection  7.3)  such  as 
a  seek/read  or  seek/write.  If  the  first  command  of  an  10  connect  is  not  a 
seek,  or  pre-seek,  then  an  entry  will  not  be  made  to  this  set  of 
histograms.  For  this  reason,  the  number  of  connects  reported  in  these 
reports,  for  a  given  device,  may  be  somewhat  lower  than  that  reported  in 
the  Proportionate  Device  Utilization  Histogram,  described  in  subsection 
7.5.20.  In  addition  to  not  recording  non-mul ticommands  such  as  controller 
commands  and  reset  status  commands,  there  are  also  a  significant  number  of 
multiconnands  that  are  issued  by  the  system  for  which  the  system  does  not 
generate  a  "valid"  seek  address  In  the  "normal"  manner.  These  connects 
will  not  be  reported  in  the  Space  Utilization  or  Seek  Movement  histograms, 
but  will  be  reported  in  the  Proportionate  Device  Utilization  Histogram. 
Research  is  currently  underway  to  determine  under  what  conditions  these 
"nonvalid'  seek  address  I/O  requests  are  generated  and  whether  there  is  any 
procedure  by  which  the  MSM  could  determine  the  correct  seek  address  (see 
subsection  7.3). 

7.5.8  Head  Movement  Efficiency  Report  (File  42).  This  report  displays  how 
many  connects  are  issued  per  arm  movement  of  the  device.  Figure  7-8  is  an 
example.  The  first  three  columns  give  the  IOM,  Channel,  and  Device  number 
of  the  device.  This  is  followed  by  the  number  of  connects  issued  to  that 
device  and  the  number  of  times  any  arm  movement  was  required  (size  of  the 
seek  is  not  considered).  The  final  column  indicates  the  ratio  of  connects 
to  arm  movements.  The  larger  this  ratio  is,  the  more  efficient  is  the 
device  (i.e.,  the  larger  is  the  number  of  connects  being  handled  between 
each  arm  movement  of  the  device).  Following  the  breakdown  of  arm  movement 
by  individual  device,  a  summary  is  presented  for  arm  movement  within  each 
Individual  mass  storage  subsystem.  This  is  followed  by  three  lines  of 
output  summarizing  the  overall  efficiency  of  the  entire  disk  subsystem. 

The  first  line  presents  the  total  number  of  connects  Issued,  the  second 
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Figure  7-8.  Head  Movement  Efficiency  Report 
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line  presents  the  total  number  of  arm  movements,  irrespective  of  the  number 
of  cylinders  traversed  by  each  movement,  and  the  final  line  presents  the 
overall  head  movement  efficiency  (line  1  divided  by  line  2).  The  only 
connects  reported  in  this  report  are  those  mul ticormand  connects  for  which 
the  MSM  was  able  to  determine  a  "valid"  seek  address  (see  subsection  7-3). 
By  examining  figure  7-8,  the  user  will  observe  that  the  MSU450s  appear  to 
be  least  efficient,  with  the  exception  of  device  number  2.  This  report  is 
always  generated  and  cannot  be  turned  off. 

7.5.9  System  File  Use  Summary  Report  (File  21).  This  report  indicates 
where  each  system  file  is  located  and  to  what  extent  it  was  accessed  across 
the  measurement  session.  Only  those  files  accessed  are  displayed.  Figure 
7-9  shows  an  example  of  this  report.  This  report  is  produced  by  default 
but  can  be  turned  off  with  the  input  option  (OFF)  (subsection  7.6.9).  The 
sum  of  accesses  to  all  system  files  is  then  expressed  as  a  percentage  of 
all  mass  storage  accesses.  The  system  files  are  those  files  defined,  via 
startup  in  the  .CRDIT  table.  As  can  be  seen  in  figure  7-9,  the  file  names 
listed  under  the  File  Marne  column  are  not  the  actual  file  name,  but  rather 
relative  file  names  indicative  of  their  position  description  within  the 
startup  deck.  Actual  file  names  can  be  output  in  this  report  if  the  user 
selects  the  input  option  described  in  subsection  7.6.4.  The  connects 
reported  are  multicommand  in  nature  and  contain  a  "valid"  seek-address  as 
captured  by  the  MSM.  (See  subsection  7.3). 

This  list  of  system  files  is  then  followed  by  a  list  of  modules  which 
reside  i.i  hard  core  because  they  are  hard  core  modules  or  because  they  have 
been  loaded  into  hard  core  by  system  personnel  in  order  to  save  on  I/O 
processing.  If  a  system  nodule  is  not  loaded  in  hard  core,  and  is  required 
for  some  processing,  then  the  system  must  perform  an  10  function  to  read 
this  nodule  from  disk  into  a  user's  SSA  work  space.  A  significant  amount 
of  such  system  10  can  cause  severe  system  degradation.  This  degradation 
can  be  reduced  by  placing  additional  system  nodules  in  hard  core  or  else  by 
increasing  the  size  of  SSA  Cache  Memory.  The  System  File  Use  Summary 
Report  and  the  following  Individual  Module  Activity  Report  should  provide 
sufficient  information  to  determine  whether  user  action  is  required  to 
reduce  system  10  overhead.  If  the  percentage  of  system  10  reported  in  this 
report  is  greater  than  5-73,  then  some  user  action  is  probably  required. 

If  addtional  hard  core  space  is  available,  the  user  should  move  as  many 
system  modules  as  possible  into  hard  core.  Each  hard  core  module  requires 
1/2K  (512  words)  of  memory,  and  there  is  64K  of  hard  core  memory 
available.  The  System  Configuration  and  Channel  Usage  Report  (subsection 
7.5.1)  indicates  the  amount  of  hard  core  currently  in  use.  The  Individual 
Module  Activity  Report  (subsection  7.5.10)  can  be  used  to  indicate  which 
system  modules  should  be  transferred  to  hard  core.  If  sufficient  hard  core 
Is  not  available,  then  the  size  of  SSA  cache  should  probably  be  increased. 
Once  again,  the  Individual  Module  Activity  Report  should  be  referenced  to 
see  if  this  type  of  action  would  aid  in  reducing  system  10. 
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7.5.10  Individual  Module  Activi ty  Report  (File  21).  This  report  shows  the 
accessing  done  to  each  system  module  (figure  7-10).  The  report  presents 
the  system  file  the  module  resides  in,  followed  by  the  module  name  and 
type.  The  module  location,  access  count,  and  percentage  of  system  file 
usage  is  then  given.  The  last  two  entries  give  the  total  number  of  SSA 
CACHE  buffer  hits  and  disk  loads  this  module  accumulated  (these  values  are 
0  if  SSA  CACHE  is  not  active).  A  minus  one  in  column  indicates  a 
nonstandard  SSA  module.  The  Number  of  Accesses  column  reports  the  number 
of  connects  made  to  this  SSA  module  as  determined  by  the  issuance  of  a 
trace  type  7.  The  Disk  Load  column  reports  the  number  of  times  the  SSA 
CACHE  logic  claims  to  have  issued  a  connect  to  this  SSA  module.  In  those 
cases  where  no  lost  data  occurred  during  the  monitoring  session  and  a  GMC 
termination  record  was  generated  (i.e.,  GMC  terminated  correctly),  these 
two  columns  should  display  equal  values.  Figure  7-10  shows  this  to  be  the 
case  for  almost  all  of  the  SSA  modules.  However,  there  are  some 
exceptions.  Module  .MALC6  shows  109  accesses  but  only  104  disk  loads 
(i.e.,  a  difference  of  five).  This  apparent  inconsistency  has  been 
reported  to  Honeywell,  and  an  explanation  requested. 

If  lost  data  occurred  during  the  monitoring  session  (i.e.,  trace  type  7 
data  lost),  the  Number  of  Accesses  column  could  be  significantly  lower  than 
the  Disk  Load  column.  If,  on  the  other  hand,  GMC  did  not  abort  cleanly  and 
a  termination  record  was  not  generated,  the  Disk  Load  column  could  be 
significantly  lower  than  the  Number  of  Accesses  column. 

Finally,  it  should  be  noted  that  data  from  the  last  two  columns  pertains 
only  to  "STANDARD  SSA"  modules  (see  the  Type  column).  Modules  that  are 
typed  as  "ABSOLUTE"  or  "EXCEPT  PROC"  are  not  placed  into  SSA  Cache  Core  and 
therefore  do  not  generate  values  for  the  last  two  columns.  This  report  is 
produced  by  default  but  can  be  turned  off  with  the  input  option  (OFF) 
(subsection  7.6.9). 

When  generating  this  report,  the  data  reduction  program  creates  a  temporary 
file  (file  code  55)  which  is  used  to  produce  a  Job  SSA  Module  Usage  Report 
(subsection  7.5.11).  If  this  report  is  desired,  the  report  must  be 
requested  via  input  option  (MODULE)  (subsection  7.6.6). 

At  the  bottom  of  this  report,  a  summary  line  is  produced  indicating  the 
percentage  of  buffer  hits  and  disk  loads.  If  the  percentage  of  buffer  hits 
is  less  than  90,  then  the  size  of  SSA  cache  should  be  increased.  For  each 
IK  increase,  2  additional  modules  will  be  loaded  into  the  SSA  Cache  memory. 

When  using  this  report  to  determine  which  additional  SSA  modules  should  be 
placed  into  GCOS  Hard  Core,  the  user  should  reference  the  "%  of  Activity" 
column.  Those  modules  with  the  largest  reported  figure  would  be  candidates 
for  movement.  In  figure  7-10,  .MALC6,  .MALC9,  .MFS03,  .MFS04  would  be 
candidates  for  movement. 
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7.5.11  SSA  Module  Usage  Report  hy  Job  (File  21).  When  requested  by  the 
user,  this  report  will  produced  a  listing  for  every  job  run  during  the 
monitoring  period,  showing  all  SSA  modules  referenced  by  that  job  and  the 
number  of  such  references.  An  example  is  shown  in  figure  7-11.  This  is 
the  best  method  to  use  when  determining  which  SSA  modules  should  be 
softloaded  into  TSS  core.  This  also  provides  an  excellent  means  for 
studying  the  usage  of  SSA  modules  in  general.  This  report  is  off  by 
default  and  must  be  requested  with  a  user  input  option  (MODULE)  (subsection 
7.6.6). 


7.5.12  File  Code  Summary  Report  (File  23)  ( NAf1E=FILEC0DE ) .  The  File  Code 
Summary  Report  lists,  by  each  activity,  the  files  allocated  to  mass 
storage,  their  location  and  size,  and  the  number  of  accesses  made  to  each 
in  the  system  during  the  monitoring  period.  Figure  7-12  is  an  example  of 
this  report.  The  activities  in  this  report  are  in  the  same  order  as  they 
appear  in  the  Activity  Sumary  Report  (see  subsection  7.5.15). 

Each  activity  is  identified  by  its  SMUM8,  activity  number,  and  $  IDENT  and 
USERID  cards.  There  are  as  many  data  lines  as  necessary  to  describe  each 
mass  storage  file  used  by  the  activity  and  the  number  of  times  the  file  was 
accessed.  There  is  one  line  per  file,  and  the  file  is  described  by  its 
two-character  file  code,  the  device  on  which  it  wa s  allocated  (ALLOCATED 
DEVICE),  its  origin  on  that  device  (FILE  ORIGIN)  in  units  of  LLINKS  (320 
words)  and  cylinders  relative  to  the  beginning  of  the  device,  and  the  size 
of  the  file  (FILE  SIZE)  in  LLINKS  and  cylinders.  The  column  heaaed 
CONNECTS  gives  the  count  of  the  number  of  accesses  made  to  the  file. 

There  are  several  special  file  codes  that  will  appear  in  this  report.  The 
following  file  codes  will  appear  for  almost  every  activity  that  is 
processed: 

00  -  Mass  storage  accesses  made  without  a  normal  PAT  entry;  e.g., 

accesses  made  by  the  operating  system  as  part  of  job  i ntial ization 
which  are  done  without  a  PAT  for  efficiency 

--  -  All  accesses  to  SYSOUT 

=9  -  File  grow,  PAT  refresh,  permanent  allocation 
=1  -  Temporary  allocation 
0%  -  Load,  pop,  or  push  of  an  SSA 
*,  -  FILSYS  catalog  search  connect 

It  should  be  realized  that  these  file  codes  are  not  used  for  a  unique  file 
request,  and  therefore  may  actually  reference  several  different  files. 
Therefore,  in  figure  7-12  it  can  be  seen  that  activity  1  for  SNUMB  2802T 
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Figure  7-12.  File  Code  Summary  Report 


made  479  connects  to  file  code  00  located  on  device  1-10-2.  In  actuality, 
the  activity  may  have  connected  to  several  different  devices,  each  time 
referencing  this  special  file  code.  Instead  of  reporting  these  connects  as 
separate  entries,  all  the  requests  are  grouped,  and  the  allocated  device 
that  is  reported  is  the  the  one  that  was  referenced  by  the  first  of  the  479 
connects.  There  is  a  user  option  available  (AREA)  that  expands  the  usage 
definition  of  these  file  codes.  This  option  will  then  display  all  files 
using  these  file  codes  rather  than  grouping  all  of  the  unique  file  codes 
into  a  single  collection  file  code. 

The  file  code  report  for  the  TSS  subsystem  will  also  contain  several 
special  file  codes.  Following  is  a  list  of  these: 

TU  -  user  files  requested  under  TSS  subsystems. 

file  code  referenced  by  TSS  that  contains  a  character  that  cannot 
be  printed.  The symbol  is  being  used  instead. 

JO  -  TSS  I/O  to  this  file  code  is  JOUT  processing. 

This  report  will,  record  all  accesses  to  a  file  that  is  made  wi th  a 
multicommand  request.  No  check  is  made  to  determine  if  a  valid  seek 
address  has  bee/i  recorded.  {See  subsection  7.3). 

Th  s  report  maj/  produce  excessive  output  and  therefore  is  not  produced 
under  default  conditions.  The  user  must  explicitly  request  this  report 
with  the  use  of  an  input  option  (ON)  (see  subsection  7.6.10). 

Each  file  code  entry  has  information  which  Indicates  the  type  of  file  by  a 
"P"  for  permanent  and  "T"  for  temporary.  This  entry  is  located  on  the 
right  side  of  the  file  code  characters.  Inmediately  to  the  right  of  the 
file  type  character  is  the  access  characteristics  of  the  file.  This  is 
denoted  by  an  "R"  if  random,  or  an  “S“  for  a  sequential  file.  The  next 
character  defines  a  permanent  file  as  cataloged,  "C",  or  noncataloged, 

"N".  This  character  for  a  temporary  file  will  be  a  blank  as  it  is  neither 
cataloged  nor  noncataloged.  GCOS  files  are  usually  defined  as 
noncataloged,  permanent  files  and  are  treated  at  startup  time  much  like 
permanent  files  by  the  file  system.  They  are  not,  however,  given  the 
allocation  treatment  during  normal  operation  time  that  is  given  to 
permanent  files.  The  final  character  is  an  "F"  for  fixed  or  an  "R"  for 
removable. 

7.5.13  Cat/File  String  Report  (File  23).  Immediately  following  the  File 
Code  Summary  Report,  the  user  will  fin?  the  CAT/File  String  Report  (figure 
7-13).  This  report  will  provide  the  CAT/File  String  for  every  permanent 
user  file  referenced  during  execution.  It  will  not  list  the  CAT/File 
String  for  any  special  system  files.  In  addition,  it  will  indicate  the 
total  number  of  connects  required  to  locate  the  file  (catalog  searching) 
every  time  the  system  was  required  to  search  for  that  file  via  a  MME 
GEFSYE.  Finally,  it  will  Indicate  the  number  of  connects  required  to 
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CAT/FILE  STRING  REPORT 


SNUMB-ACT 

FILE  COOE 

CONNECTS 

CONM/GFYS 

CAT/FILE  STRING 

8174T-  0 

H* 

70 

10.000 

A1 6 1 DP  XO/tfST AR/ H . DMS/ 

8174T-  0 

H* 

10 

10.000 

A16IDPX0/HSTAR/H.MSFMAC/ 

8174T-  0 

H* 

9 

9.000 

A1 6 1  DP  XO/HST AR/ H . MSFMOD/ 

8174T-  0 

PL 

12 

4.000 

A1 6 I DPXO/L I NK/PLUSL IB/ 

8174T-  3 

H* 

20 

10.000 

A1 6 1 DP  XO/HST AR/H . DMS/ 

8174T-  4 

H* 

20 

10.000 

A16IDPX0/HSTAR/H.DMS/ 

8174T-  5 

H* 

20 

10.500 
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Figure  7-13.  Cat/FIle  String  Report 


locate  the  file  per  fIME  GEFSYE.  It  will  also  provide  the  file  code 
assigned  to  the  file  so  that  a  cross  reference  can  be  made  to  the  File  Code 
Sumary  Report.  This  report  is  off  by  default  and  must  be  explicitly 
requested  with  the  user  input  option  (CAT)  (see  subsection  7.6.17). 

In  creating  a  structure,  a  user  must  be  aware  of  the  accesses  that  are 
required  to  actually  obtain  a  file.  Since  the  SMC  is  divided  into  32 
sections  and  each  section  is  accessed  via  a  hash,  a  user  name  can  usually 
be  found  with  one  disk  access.  This  is  true  if  the  total  number  of 
different  user  names  is  no  more  than  300  and  all  userids  are  evenly 
distributed  over  the  32  sections.  It  should  also  be  noted  that  SMC 
contention  (FMS  attempting  to  access  more  than  one  SMC  entry  in  the  same 
section  at  the  same  tine)  can  be  significantly  reduced  by  an  even 
distribution  of  user  names  across  the  32  sections. 

The  UMC  is  arranged  so  that  access  to  the  file  description  for  one  of  the 
first  four  files  or  catalogs  cataloged  for  a  user  requires  one  disk  access, 
to  one  of  the  first  18  files  requires  one  or  two  disk  accesses,  to  one  of 
the  first  37  requires  one,  two  or  three  accesses  and  so  on. 

If  a  large  number  of  files  are  cataloged  under  the  same  user,  allocation  of 
the  most  of  these  files  will  be  slow,  since  locating  their  file 
descriptions  requires  many  disk  accesses.  For  example,  if  there  are  1000 
files  cataloged  under  a  single  user,  allocating  any  one  of  the  500  files 
listed  last  requires  between  28  and  54  disk  accesses. 

When  it  is  necessary  to  include  a  large  number  of  files  under  one  user 
name,  using  subordinate  catalogs  each  to  include  a  fraction  of  the  total 
can  reduce  the  number  of  disk  accesses. 

Most  the  connects  being  displayed  by  this  report  are  not  attributed  to  the 
particular  job  in  the  File  Code  Summary  Report.  Rather  the  large  portion 
of  these  connects  are  attributed  to  the  Peripheral  Allocator,  file  (*,), 
since  it  is  the  Peripheral  Allocator  that  is  responsible  for  issuing  the 
MME  GEFSYEs  required  to  locate  a  given  user  file. 

In  figure  7-13,  we  see  that  job  8174T,  activity  0,  has  three  references  to 
file  code  H*,  where  each  H*  is  to  a  different  Cat/File  string.  The  reason 
for  this  is  that  during  allocation  (activity  0)  the  peripheral  allocator 
must  insure  that  all  files  referenced  in  the  entire  job  are  available  to  be 
used  by  this  job.  For  job  8174T  file  H.DMS  is  asigned  to  H*  in  activities 
3,  4,  5,  6,  7,  8  and  9,  while  file  H.MSFMAC  is  assigned  to  H*  in  activity 
10  and  file  H.MSFMOD  is  assigned  to  H*  in  activity  11.  Therefore,  since 
three  different  files  are  assigned  to  file  code  H*  during  the  course  of  the 
job,  activity  0  of  that  job  will  display  three  different  references  to  file 
code  H*.  The  reader  will  notice  that  file  H.DMS  is  actually  used  in 
activities  3,  4,  5,  C,  7,  8  and  9,  and  that  during  activity  0  the 
peripheral  allocator  actually  searched  for  this  file  7  times  for  a  total  of 
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70  connects,  or  10  connects  per  search.  Then  during  the  activity  in  which 
it  v<as  actually  used,  an  additional  two  catalog  searches  (20  connects)  were 
also  required. 

7.5.14  Connect  Sunnary  Report  By  Useri d/SNUMB  (File  23).  If  the  user  does 
not  want  to  produce  a  complete  Pile  Code  Sumary  Report,  he  may  request 
that  a  report  be  produced  for  only  certain  USERIDs  and/or  SNUMBS.  In  this 
case,  a  much  smaller  File  Code  Summary  Report  (subsection  7.5.12)  report 
will  be  produced.  In  addition,  the  user  will  receive  a  Connect  Summary 
Report  which  will  indicate,  for  the  requested  items,  the  number  of  tines 
that  USERID  or  SNUMB  was  referenced,  the  total  number  of  connects  made  by 
that  individual  and  the  *  of  total  connects  represented  by  that  item.  If  a 
requested  SNUMB  has  a  USERID  equal  to  a  requested  USERID,  then  it  will  be 
reported  twice  in  this  report.  See  figure  7-14  for  a  sample  of  this 
report.  This  report  is  not  produced  by  default  and  must  be  requested  by  a 
user  input  option  (PROJ)  (subsection  7.6.11). 

7.5.15  Activity  Summary  Report  (File  24).  The  Activity  Sumary  Report 
lists  each  activity  processed  during  the  monitoring  period  and  surma rizes 
the  activities  as  character)  zed  by  the  five  variables:  CP  Time,  Mass 
Storage  Connects,  Total  Connects,  and  CP  Time  Per  Connect  (Mass 
Storage/Total)  (see  figure  7-15).  The  report  lists  the  SMUMB-ACTIVITY 
number,  the  CP  TIME  (in  milliseconds)  charged  by  accounting  to  the  job 
during  the  monitoring  period,  the  number  of  connects  issued  to  Mass 
Storage,  the  number  of  connects  issued  to  Mass  Storage  and  Tape,  and  the 
ratio  of  CP  time  over  accesses  for  both  Mass  Storage  Accesses  and  Mass 
Storage  and  Tape  Accesses  in  the  column  headed  CP  TIME  PER  CONNECT.  The 
bottom  line  of  this  report  is  titled  TOTALS  and  gives  the  total  charged 
processor  time,  the  total  connects,  and  the  ratio  of  these  totals. 

The  mass  storage  connects  are  displayed  along  with  the  total  connects.  For 
example,  $PALC  issued  167  mass  storage  connects  and  411  total  connects. 

This  represents  13,241.93  milliseconds  of  CPU  time  per  mass  store  connect 
and  only  5,380.54  milliseconds  of  CPU  time  between  any  connect  type. 

A  line  of  asterisks  are  output  when  the  monitor  terminates  in  order  to 
signify  that  the  jobs  that  follow  did  not  necessarily  terminate. 

Information  known  about  each  job  at  the  monitor  termination  is  output. 

This  report  is  on  by  default  but  may  be  turned  off  v/ith  a  user  input  option 
(OFF)  (subsection  7.6.9). 

The  report  is  useful  in  two  applications.  First,  a  quantitative  feel  for 
the  CPU  I/O  balance  of  the  system  operation  may  be  obtained  from  the  TOTALS 
ratio  of  CP  TIME  PER  CONNECT.  Secondly,  particular  jobs  which  use 
excessive  amounts  of  CPU  or  I/O  time  may  be  identified  by  SNIWB  by  scanning 
the  list.  More  details  on  file  usage  of  each  activity  in  the  Activity 
Summary  Report  are  given  on  the  File  Code  Sunmary  Report.  The  $IDENT  card 
of  the  job  can  also  be  found  there  for  a  more  complete  job  identification. 
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CONNECT  SUMMARY  REPORT  BY  USERID/SNUMB  FOR  SYSTEM  NMCC2  OH  81-09-20 
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ACTIVITY  SUMMARY  REPORT  FOR  SYSTEM  NMCC  ON  81-12-01 


O 
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Figure  7-15.  Activity  Summary  Report 


This  report  will  display  all  connects  issued  by  a  job  with  no  regard  to  the 
type  of  I/O  command  or  the  validity  of  the  seek  address  (see  subsection 
7.3). 


7.5.16  Device  Area  File  Code  Reference  Report  (File  22).  This  report  is 
generated  to  provide  details  on  the  jobs  accessing  a  specific  device  area 
with  their  file  codes.  Figure  7-16  displays  an  example.  The  devices  and 
areas  to  be  listed  are  defined  by  the  user  when  requesting  input  option 
Area  (subsection  7.6.1).  In  figure  7-16,  there  are  10  areas  requested  for 
investigation.  Each  activity  that  accessed  a  device  area  is  displayed  in 
the  report.  At  the  end  of  the  report,  the  number  of  connects  found  to  each 
requested  area  is  also  given.  This  report  is  identical  in  format  to  the 
File  Code  Summary  Report  (subsection  7.5.12)  except  that  this  report 
contains  only  the  file  codes  which  referenced  the  specific  area  of  the 
desired  devices.  The  AREA  N  of  each  file  code  specifies  within  which  area 
of  the  possible  set  of  requested  areas  this  particular  file  code  fell, 
lihen  this  option  is  selected,  the  file  code  reference  will  automatically  be 
expanded  and  special  system  file  codes  will  be  reported  only  if  they 
actually  referenced  the  requested  area  (see  subsection  7.5.12).  In 
addition,  if  the  special  system  file  codes  referenced  multiple  areas,  these 
file  codes  will  appear  multiple  times  within  this  report.  In  figure  7-16, 
it  can  be  seen  that  activity  3  of  job  52323  has  multiple  references  to  file 
code  0".  In  the  standard  File  Code  Summary  Report,  all  these  references 
would  have  been  grouped  as  a  single  reference,  but  in  this  report,  they  are 
expanded  within  each  unique  area  requested  by  the  user. 

A  complete  explanation  of  the  special  file  codes  can  be  found  in  subsection 
7.5.12.  This  report  is  not  produced  under  default  conditions  and  must  be 
requested  with  a  special  user  input  option  (AREA)  (subsection  7.6.1). 

7.5.17  Device  File  Use  Summary  Report  (File  21).  This  report  shows  the 
device  use  by  the  accesses  per  file  class  (temporary  or  permanent).  Figure 
7-17  is  an  example  of  this  report.  Each  of  these  classes  of  allocation  is 
subdivided  into  sequential  and  random  files  and  their  corresponding 
percentage  of  the  total  file  use  is  presented  in  the  report.  File  00 
accesses  are  not  included  in  this  report.  This  report  will  reflect  only 
mul ti command  connects,  but  will  make  no  check  as  to  the  validity  of  the 
seek  address  (see  subsection  7.3).  The  device  numbers  oeing  reported  under 
the  "DEVICE"  column  are  the  unique  set  of  device  numbers  generated  by  the 
MSMDRP  (see  subsection  7.5.5).  This  report  is  on  by  default  but  may  be 
turned  off  with  a  user  input  option  (OFF)  (subsection  7.6.9). 

7.5.18  Chronological  Device  Utilization  Report  (File  26).  This  report 
provides  a  chronological  listing  of  the  six  most  active  disk  devices,  by 
device  number  and  their  probability  of  utilization  (see  figure  7-18).  This 
report  is  so  designed  that  any  time  quantum  can  be  set  in  the  report.  By 
varying  the  time  quantum  parameter,  the  user  may  select  integer  values  from 
1  to  n  (where  n  is  a  positive  value  In  seconds).  A  time  quantum  variation 
is  requested  with  a  user  input  option  (TIMEQ)  (subsection  7.6.14). 
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Figure  17.  Device  File  Use  Summary  Report 


CHRONOLOGICAL  REPORT  OF  DEVICE  UTILIZATION  FOR  SYSTEM  OSCC2  ON  79-10-25 
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Figure  7-18.  Chronological  Device  Utilization  Report 


The  default  tine  parameter  is  set  for  60  seconds  and  prints  the  6  most 
active  disk  devices  over  each  minute  of  monitoring  time.  The  first  column 
shows  the  tine,  starting  at  the  beginning  and  terminating  at  the  ending 
time  of  the  tape  or  timeframe.  The  remaining  columns  show  six  disk 
devices,  by  device  number  with  their  probability  of  utilization, 
consecutively,  in  descending  order,  relative  to  the  activeness  of  all  the 
disk  devices.  The  utilization  is  the  probability  of  that  device  being 
accessed  over  the  tine  quantum.  By  examining  figure  7-18,  one  can  see  that 
device  4  is  the  most  active  disk  device  with  device  21  being  a  very  close 
second.  The  device  numbers  being  reported  under  the  "DEVID"  column  are  the 
unique  set  of  device  numbers  generated  by  the  MSMDRP  (see  subsection 
7.5.5).  This  report  is  not  produced  by  default  and  must  be  requested  with 
an  input  option  (ON)  (subsection  7.6.10). 

7.5.19  FMS  Cache  Report  (File  21).  If  the  system  being  monitored  is 
configured  with  FMS  cache,  "the  report  shown  in  figure  7-19  will  always  be 
generated  and  cannot  be  turned  off.  At  the  current  time,  the  actual 
meaning  and  importance  of  the  various  data  items  are  not  known.  The  data 
items  are  internal  counters  generated  by  6C0S  in  its  own  monitoring  of  FMS 
Cache  operation.  A  study  is  currently  underway  to  get  a  full  definition  of 
each  of  the  reported  values,  and  when  the  study  is  completed,  and  update  to 
this  section  will  be  written. 

7.5.20  Proportionate  Device  Utilization  Report  (File  42).  This  report 
shows  the  proportionate  utilization  of  each  device  configured  on  the  mass 
storage  subsystem.  Figure  7-20  is  an  example.  This  histogram  identifies 
each  unique  device  ID  (device  number  zero  is  an  ff>C  controller)  and 
provides  both  a  count  of  the  number  of  accesses  made  to  each  device  (under 
the  column  headed  INDIY.  NUMBER)  as  well  as  the  percent  of  all  accesses 
which  were  to  each  device  (under  the  column  headed  IMDIV.  PRC).  The 
histogram  shows  the  proportionate  utilization  of  each  device  ( i . e . ,  the 
percent  of  all  accesses  which  went  to  each  device)  in  a  graphical  form. 

The  physical  device  that  each  "Device  ID"  of  the  histogram  represents  is 
shown  in  the  Physical  Device  ID  Correlation  Table  (see  figure  7-5).  This 
report  is  always  generated  and  cannot  be  turned  off.  In  this  report  the 
user  is  looking  for  a  device  or  devices  which  have  significantly  more 
utilization  than  others  in  the  system.  This  highly  used  device  would  then 
be  a  potential  bottleneck. 

It  is  desirable,  but  not  always  practical,  to  have  equal  utilization  for 
each  device.  The  user  should  be  reminded  that  data  in  figure  7-20  is 
cumulative  over  the  monitoring  period.  The  actual  accessing  pattern  could 
have  been  periodic  with  the  following  form:  Many  accesses  to  device  4 
followed  by  many  accesses  to  device  3  followed  by  many  accesses  to  device  2 
followed  by  many  accesses  to  device  1,  etc.  Each  device  could  have  been  a 
bottleneck  for  a  subperiod  of  the  total  monitoring  period.  This  could  also 
have  been  the  case  if  the  proportionate  utilization  of  each  device  was 
equal.  The  Channel  Monitor  can  be  used  to  uncover  this  cyclic  type  of 
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Figure  7-19.  FMS  Cache  Report 


usage.  In  addition,  the  Chronological  Device  Utilization  Report  {see 
subsection  7.5.18)  was  designed  to  uncover  this  type  of  problem  by  breaking 
down  device  utilization  over  tine,  rather  than  by  utilizing  a  histogram. 
Nevertheless,  when  a  single  or  small  number  of  devices  has  a 
disproportionately  large  share  of  the  accesses,  they  are  potential 
bottlenecks  and  their  usage  should  be  further  analyzed. 

This  report  will  show  all  connects  that  were  issued  to  a  given  device. 

This  includes  all  read/wri te  connects,  as  well  as  any  command  type  connects 
issued  to  a  given  device. {See  subsection  7.3). 

7.5.21  Elapsed  Time  Between  Seeks  Report  (File  42).  This  is  a  histogram 
report  for  the  frequency  of  occurrence  of  elapsed  time  intervals  between 
the  issuance  of  mass  storage  access  connects.  Figure  7-21  presents  a 
sample.  The  elapsed  time  is  calculated  as  the  time  difference  between 
successive  mass  storage  connects  from  the  central  system  and  thus  is 
representative  of  the  workload.  It  does  not  provide  any  meaningful 
information  on  the  subsystem  service  capabilities. 

The  data  presented  give  the  count  (INDIV.  NUMBER)  and  percentage  (INDIV. 
PRC)  of  elapsed  time  between  accesses  which  fell  within  each  time  range. 

The  column  headed  TIME  MSECS  gives  the  time  range  in  milliseconds.  Thus, 
the  data  of  the  row  with  a  time  of  18  gives  the  count  and  fraction  of 
elapsed  time  intervals  in  the  range  of  17+  to  18  milliseconds.  The  columns 
headed  CUMUL.  NUMBER  and  CUMUL.  PRC.  give  the  accumulated  counts  and 
percentage  and  are  useful  in  describing  the  mass  storage  rates,  e.g. ,  75.4 
percent  of  the  accesses  occur  less  than  21  ms  after  the  last  access. 

The  bottom  of  the  report  provides  a  statistical  summary  of  the  data  in  the 
report.  Statistics  given  include  average,  variance,  and  standard 
deviation.  These  statistics  apply  to  all  data  points  that  were  measured. 
The  statistics  concerning  OUT  OF  RANGE  are  for  those  data  points  which  fall 
outside  the  range  of  the  histogram.  OUT  OF  RANGE  points  are  included  in 
the  previous  statistics.  This  report  is  always  generated  and  cannot  be 
turned  off. 

7.5.22  Data  Transfer  Size  Report  (File  42).  A  sample  histogram  report  on 
the  frequency  of  occurrence  of  sizes  of  the  data  blocks  transferred  between 
mass  storage  and  main  memory  is  given  in  figure  7-22.  Refer  to  subsection 
7.5.12  for  a  description  of  the  histogram  format.  This  report  has 
Increments  of  64  words,  and  the  number  in  the  column  headed  NUMBER  WORDS  is 
the  upper  value.  The  occurrence  of  certain  data  transfer  sizes  should  be 
anticipated.  For  example,  64-word  blocks  are  used  for  catalog  accessing; 
in  other  parts  of  GCOS,  standard  system  format  is  320  words.  SSA  modules 
are  usually  slightly  less  than  512  words.  Special  user  application  data 
base  structures  may  use  a  different  but  observable  block  size,  and  this 
report  will  give  an  indication  of  the  relative  frequency  of  reference  to 
that  data  base.  It  should  be  noted  that  this  data  is  derived  by  the 


7-39 


oc 

c  CM 
cl 


h 


i 

CO 

? 

co 


ao 

CO 


VO 

CO 


CO 


O  ' 

U“> 


un 


o  ■ 


LT) 

CO 


O  « 
CO 
LU 
O 

z 

LU  Lf)  i 
CC  CM 
OC 


O  O  ' 
O  CM 


LO 


00 

VO 

r-* 

CO 


o 
►— « 

< 


LU 

O 

Q 

CC 

< 

a 


vo 


o 

o 

CM 

LO 

CO 


<M  Z 
O  LU 

S  £ 


£  x 

<S)  H- 

Z  Q 

O  LU 

CO 

2  S 


8 

o 


</> 

Q 


O 

oc  o  < 


Lf) 

X 

X 

X 

X 

X 

X 

o  • 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

• 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

• 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

• 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

Or-CjrO^-in^NCOC^O 


X  O  I  I  I  I  I  l  I  I  I  I  I  I  I  1  I  I  I  I  I 
i-»uj  o  CMCo^unvof^cooor-cMco^-Lovor^co 


vofowcir-inntvjfo^r-^win'o^^voos 
vo^-cMLnvovoOooONCOCMe— coloovCNloo**- 
ONVOflOPNO^r-Nir)CsJOCD>OfOCVJOCONl/)CM 

OCMCSJCO^^f^LO^-Tf^-^COCOCOCOCOCMCMCMCSJ 


o£ 

Z  CL 


VO  o>  < 


2£ 
=3  a. 
o 


i  op  i**  __  .  .  _  __ 

«o  wffiwcMMo 


,  oo  ro  vo  oo 


_ _ _ _nirtvooo<NJCOoooo«tf-«tf,o 

OMVNOOf-ciWNMnp-uiseoNinOM 


o<vi^con®i*)«NN.r-K>otr)«»Mifl«f-(n 

i-r-MM(*)n»fTf^ifununovoqM^ 


£ 

< 


cm  o  ^  i/mo  rs  co  oi  o 

<T> 

o 

co 

o 

1  1  1  1  1  1  1  1  1 

1 

ON 

<Mco^?-Lovor^cooio 

<T> 

00 

VO 

vo 

CM 

O 


Ul 

CD 

LU 

< 


o> 


ii 

o  z 


VO  CO  00 


CO 

Lf) 

VO 

vo 

CM 

00 

00 

2 

CM 

vo 

00 

CM 

vo 

CM 

r*. 

CM 

00 

Cv 

Vf> 

CO 

If) 

ON 

r^ 

CO 

O) 

Lf) 

00 

CO 

r** 

CO 

r»* 

vo 

ON 

00 

o 

Lf) 

VO 

** 

o\ 

CM 

CM 

CM 

r— 

o 

00 

vo 

o  • 

•  •  co 

ON 

o 

CO 

If) 

VO 

c*. 

00 

00 

ON 

o 

r-* 

1^— 

C— 

r*“ 

CM 

CM 

CM 

o 

00 


•  a 

>  Ui  OW^jM^OCOlflCMf-OvO^OOfO^WN^ 
»-?  CO  ^NNlONipLOtoWVOWlrtOflOCDCir-  "f  GO  Lf) 


I  CP 

!5 


O) 

VO 


Q0<mvCN'CNr-r-lflcr5  COwn^C0®ON^*f 
NOfoo^^nocsjr-ooc^o^«coNrs<6 


VO 
•  vo 


R 

CM 

co 

CM 


7-40 


Figure  7-21.  Elapsed  Time  Between  Seeks  Report 
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monitor  from  a  scan  of  the  DCW  list  at  connect  time.  Any  I/O  which  uses  an 

"embedded  DCW"  list  technique,  or  includes  a  transfer  DCW  in  the  list,  nay 

not  have  its  size  correctly  recorded  by  the  monitor.  The  size  recorded 
will  be  less  than  the  actual  size  for  these  special  cases.  This  report  is 
always  generated  and  cannot  be  turned  off. 

7.5.23  Number  of  DCWs  per  Connect  Report  (File  42).  The  distribution 

length  of  the  DCW  list  per  connect  is  displayed  in  figure  7-23.  Refer  to 

subsection  7.5.12  for  a  description  of  the  histogram  format.  As  mentioned 
in  subsection  7.5.22,  an  "embedded  DCW"  or  TDCW  nay  record  a  shorter  than 
actual  length.  This  report  is  always  generated  and  cannot  be  turned  off. 

7.5.24  Connects  Per  Minute  Report  (File  20).  This  report  (figure  7-24) 
provides  a  time-oriented  summary  of  the  number  of  connects  issued  by  all 
jobs  executing  in  the  system,  by  the  Timesharing  Subsystem,  and  by 
specially  defined  user  jobs. 

This  report  would  be  useful  in  a  study  of  Time  Sharing  Response.  If  Time 
Sharing  Response  was  known  to  be  bad  during  a  given  time  period,  this 
report  would  provide  some  indication  as  to  whether  or  not  the  rate  of  I/O 
was  excessive  during  that  period.  This  report  is  off  by  default  and  must 
be  turned  on  with  a  user  input  option  (Of!)  (subsection  7.6.10).  The  time 
quantum  control  has  a  default  value  of  10  minutes  but  can  be  varied  by  a 
user  input  option  (RATECH)  (subsection  7.6.16).  If  specially  defined  user 
jobs  are  to  be  reported,  the  user  input  option  RATE  must  be  invoked 
(subsection  7.6.18). 

7.5.25  Special  Processing  Messages.  During  the  course  of  processing, 
several  special  processing  messages  may  be  generated  by  the  MSMDRP .  Most 
of  these  are  for  information  purposes  only  and  can  be  ignored  by  the 
analyst.  Following  is  a  list  and  brief  explanation  of  the  most  common 
messages.  These  messages  will  most  normally  occur  immediately  in  front  of 
the  System  Configuration  and  Channel  Usage  Report. 

o  MONITOR  MUM  WAS  ACTIVE  .... 

This  message  is  produced  for  each  monitor  that  v/as  active  during 
the  monitoring  session. 

o  MSM  DATA  REDUCED  FROM  CHANNEL  MONITOR  .  .  . 

The  MSM  was  not  active  during  the  monitoring  session  but  the 
Channel  Monitor  was  active.  Sufficient  information  is  collected 
so  that  all  reports  from  the  MSMDRP  can  be  generated  with  the 
exception  of  the  SSA  cache  portion  of  the  Individual  Monitor 
Activity  Report  (see  subsection  7.5.10). 

o  RUN  BEING  TERMINATED.  DATA  FOR  MONITOR  .  .  . 

Neither  the  MSM  or  CM  were  active  and,  therefore,  no  reports  can 
be  produced. 

o  PROCESSOR  #  N  IS  (AVAILABLE/RELEASED)  AT  (TIME) 

This  message  will  Indicate  the  assignment  or  releasing  of 
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processors  and  provides  the  processor  number  involved  as  well  as 
the  tine  of  day  the  assignment/releasing  of  processors  occurred. 

0  FOLLOWING  PRINTS  ARE  THE  INPUT  OPTIONS  .  .  . 

An  echo  print  of  all  nonstandard  input  options  selected  will  be 
produced.  If  any  input  option  is  described  incorrectly,  an  error 
message  will  be  generated  indicating  the  type  of  error  and  the 
card  nunber  in  error.  The  user  should  correct  the  error  and 
resubnit  the  job  for  processing. 

o  FOR  INFORMATION  ONLY 

This  message  will  then  be  followed  by  several  lines  of  output 
describing  special  record  types  that  have  been  processed,  or 
special  processing  events  that  have  been  executed  by  the  MSMDRP. 

In  most  cases,  the  message  can  be  ignored.  Those  messages  which 
are  important,  and  reveal  an  error  in  processing  logic,  will  be 
described  below.  All  other  messages  will  not  be  described. 

o  JULIAN  DATES  ARE  BAD  -  RUN  TERMINATED 

Every  GMF  data  record  is  preceded  by  the  current  Julian  date.  The 
MSMDRP  has  found  a  Julian  date  that  does  not  agree  with  the  Julian 
date  found  on  previous  records.  This  can  occur  when  an  old  GMF 
data  tape  is  reused  without  degaussing.  Old  data  is  on  the  tape, 
and  if  the  new  data  failed  to  write  an  end  of  file  mark  on  the 
tape  because  of  a  system  crash  or  malfunction,  the  MSMDRP,  after 
reaching  the  end  of  the  new  data,  would  attempt  to  process  the  old 
data  without  realizing  that  it  was  old.  The  check  on  the  Julian 
date  prevents  this  from  happening.  The  MSMDRP  will  terminate 
cleanly  and  all  reports  will  be  produced. 

o  HAVE  INCREASING  OR  BAD  SEQUENCE  NUMBERS  .  .  . 

A  problem  has  occurred  in  reading  the  data  tape.  If  the  run  is 
reprocessed,  the  error  may  disappear.  If  it  reoccurs,  then  the 
tape  was  generated  with  an  error.  In  most  cases,  the  MSMDRP  will 
recover  and  processing  will  not  be  significantly  affected.  If  it 
occurs  often,  contact  CCTC/C751. 

0  PROCESSING  TERMINATED  BY  NXTRECRD  .  .  . 

MSMDRP  has  requested  the  operator  to  mount  a  new  tape  and  the 
operator  responded  that  he  did  mount  the  new  tape.  However, 

MSMDRP  is  unable  to  match  the  inital  record  on  the  new  tape  with 
the  last  record  on  the  old  tape.  User  should  check  the  data 
collection  procedure  to  insure  that  correct  tapes  were  mounted 
during  the  data  collection  phase.  MSMDRP  will  terminate  cleanly 
and  all  reports  will  be  produced. 

o  INCURRED  A  BAD  SEEK  ADDRESS  .  .  . 

In  the  logic  processing  of  subroutine  SYSTMFIL,  an  unexpected 
condition  has  occurred.  MSMDRP  will  continue  processing 
correctly,  but  if  this  occurs  frequently,  CCTC/C751  would  like  to 
be  notified.  Call  202-695-0856. 
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7. 6  Default  Option  Alteration 

Most  users  rely  upon  the  standard  MSM  Report  formats  and  their  default 
values  as  these  suit  a  wide  range  of  needs-  A  capability  to  change  the 
reports  is  built  into  MSMDRP.  The  general  form  for  all  option  requests  are 
as  follows:  The  first  card  contains  an  action  code  describing  the  action 
to  be  taken.  Subsequent  cards  nodify  report  parameters  for  some  of  the 
action  codes.  All  input  cards  are  free  format  with  the  only  requirement 
being  that  at  least  one  blank  space  separates  multiple  input  parameters. 

The  very  last  input  card  must  have  the  word  "END"  entered  in  it.  This  card 
must  be  present  whether  or  not  any  other  input  options  are  selected. 


There  is  no  specific  order  required  of  the  options,  and  multiple  entries  of 
each  are  permissible.  If  several  inputs  refer  to  the  same  report,  the  last 
one  encountered  will  have  precedence.  If  a  report  is  turned  off  by  default 
and  is  modified,  it  will  be  turned  on  through  the  request  for 
modification.  The  chart  below  shows  the  available  actions:  the  mnemonic 
code  for  the  user  to  identify  the  action;  the  function;  and  the  default. 


Mnemonic 

AREA 

DEBUG 

ERROR 

FILDEF 

END 

MODULE 

NCONN 


Function  Default  (indicated  in  parentheses) 

Request  file  code  references  made  to  a  specific 
area  of  a  specific  device  (not  provided) 

Debug  (no  debug) 

Do  not  stop  on  Input  Error  (stop) 

Define  system  files  by  name  (no  names  used) 

This  card  must  be  present 

Produce  the  SSA  Module  Usage  Report  by  Job 

(no  report  produced) 

Process  a  limited  number  of  connects 

(total  tape  processed) 


NREC  Process  a  limited  number  of  tape  records 

(total  tape  processed) 

OFF  Turn  reports  off  (all  reports  ON  except  reports  12,16, 

18,20  -  see  table  7-1 ) 

ON  Turn  reports  on  (all  reports  on  except  reports  12,16, 

1 8, 20  -  see  table  7-1 ) 

PROJ  Produce  the  Connect  Summary  Report  by  Userid/SNUMB 

(no  report  produced) 
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RN  This  option  must  be  selected  when  .MSMDRP  is  used  to 

process  UW6.4  data  or  when  MSMDRP  is  executed  on  a  WW6.4 
system  (process  WW7.2/4JS  data  on 

a  WW7.2/4JS  system) 

TIME  Set  a  timespan  for  measurement  (no  time  criterion) 

TIMEQ  Change  time  quantum  for  Chronological  Device 

Utilization  Report  (report  is  off  -  default 

value  i s  60  seconds) 

USERID  Suppress  userids  from  reports  (userias  printed) 

RATECH  Change  time  quantum  for  Connects  Per  10  Minute  Report 

(report  is  off  -  default  value 
is  10  mi nutes) 

CAT  Turn  on  the  Cat/File  String  Report  (report  off) 

RATE  Request  the  Connect  Per  10  Minute  Report  for  specific 

user  jobs. 

7.6.1  Monitor  a  Specific  Device  Area  (Action  Code  AREA).  This  option 
allows  a  user  to  specify  specific  areas  of  a  device  for  which  all  jobs 
referencing  this  area  are  to  be  highlighted.  The  format  of  the  display  is 
that  of  a  File  Code  Summary  and  contains  those  jobs  and  file  codes  that 
reference  the  area  of  interest. 

The  device  to  be  investigated  is  identified  via  the  PUB  and  IOM  number. 

The  specific  areas  of  interest  are  identified  as  beginning  at  the  starting 
address  defined  in  llinks.  The  length  of  the  area  is  also  in  llinks,  with 
a  zero  meaning  the  end  of  the  device.  A  total  of  ten  possible  areas  are 
allowed.  The  format  for  this  card  is  shown  in  figure  7-25. 

See  subsections  7.5.12  and  7.5.16  for  complete  details  on  the  report  format 
generated  with  this  user  option.  This  report  is  off  by  default  and  will  be 
activated  by  the  processing  of  this  action  code. 

7.6.2  System  Debug  (Action  Code  DEBUG).  This  is  a  restricted  option  for 
GMF  system  developers.  DEBUG  should  only  be  used  with  guidance  received  by 
CCTC/C751 . 

7.6.3  Continue  Data  Reduction  After  an  Input  Option  Error  (Action  Code 
ERROR).  This  option  allows  data  reduction  to  continue  when  an  error  has 
been  detected  and  reported  in  an  Input  option  request.  The  default  value 
reports  the  error  and  aborts  the  data  reduction  procedures.  The  format  for 
this  option  is  the  word  ERROR  on  the  data  card. 

7.6.4  Specify  System  File  Names  (Action  Code  FILDEF).  This  option  allows 
the  user  to  specify  the  name  of  each  system  file  displayed  in  the 


% 


7-47 


Card  1  =  A 
Card  2  =  N 
Card  3  =  B  C  D  E  F 

Where 

A  =  The  word  AREA 

N  *  The  number  of  areas  to  be  specified.  A  maximum  of  ten  areas  are 
permitted.  A  Card  #3  must  be  present  for  each  area  requestred. 

B  =  IOM  number 
C  =  Pub  number 
D  =  Device  number 
E  =  Starting  address  in  11  inks 
F  =  Length  of  area  in  11  inks 


The  following  definitions  apply  to  this  option. 


Device 

numbers 

Number  Sectors/ 

Number  Sectors/ 

Type 

Cylinders 

Cylinder 

Block  (LLINK ) 

180 

200 

360 

5 

181 

200 

360 

5 

190 

407 

589 

5 

191 

407 

760 

5 

450 

811 

760 

5 

Figure  7-25.  Specific  Device  Area  P«eport  Card  Input 
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System  File  Use  Sunmary  Report  discussed  in  subsection  7.5.9.  This  option 
is  specified  with  a  set  of  data  cards.  The  first  data  card  contains  the 
word  FILDEF.  The  second  data  card  contains  the  number  of  system  files  to 
be  described  on  the  following  cards.  The  following  cards  each  contain  a 
single  pair  of  data  points  separated  by  at  least  one  blank.  The  first  data 
point  is  the  system  file  number  and  the  second  data  point  is  the  desired 
system  file  name. 

The  standard  output  of  the  System  File  Use  Sunnary  Report  is  to  label  each 
systen  file  as  System  File  1,  System  File  2,  etc.,  corresponding  to 
GCOS-HI-USE,  GCOS-LO-USE,  etc.  In  order  to  know  the  correct  order  of  the 
file  names,  the  user  should  check  the  $  FILES  section  of  the  startup  deck. 
The  order  of  the  files  in  the  $  FILES  section  of  the  startup  deck  is  the 
order  they  are  referenced  in  the  report. 

7.6.5  End  Card  (Action  Code  END).  This  card  must  be  present  at  all  times 
and  must  oe  the  last  data  card  supplied.  It  consists  of  the  word  END 
entered  on  the  card. 

7.6.6  Produce  the  SSA  Module  Usage  Report  by  Job  (Action  Code  MODULE). 

This  option  allows  the  user  to  produce  the  SSA  Module  Usage  Report.  This 
report  will  list  every  SSA  module  used  by  every  job  that  was  run  during  the 
monitoring  session.  See  subsection  7.5.11  for  details  concerning  this 
report.  This  report  is  off  by  default  and  cannot  be  turned  on  by  using  the 
ON  option.  This  report  can  be  activated  only  by  entering  MODULE  on  the 
data  card. 

7.6.7  Record  Limitation  by  Connects  (Action  Code  MCONN).  This  option 
allows  a  user  to  process  only  a  specific  number  of  connects.  This  option 
is  especially  useful  if  the  tape  contains  an  error  on  it  and  cannot  be 
completely  processed.  Using  this  option,  the  user  can  process  the  tape  or 
tapes  up  to  the  point  where  the  tape  error  exists.  This  option  requires 
two  data  cards.  The  first  data  card  contains  the  word  HCONN  with  the 
second  card  containing  the  number  of  connects  to  be  processed. 

7.6.8  Record  Limitation  by  Records  (Action  Code  NREC).  This  option  allows 
a  user  to  process  only  a  specific  number  of  tape  records.  This  option  is 
especially  useful  if  the  tape  contains  an  error  on  it  and  cannot  be 
completely  processed.  Using  this  option,  the  user  can  process  the  tape  or 
tapes  up  to  the  point  where  the  tape  error  exists.  This  option  requires 
two  data  cards.  The  first  data  card  contains  the  word  NREC  with  the  second 
card  containing  the  number  of  tape  records  to  be  processed. 

7.6.9  Turn  a  Report  Off  (Action  Code  OFF).  This  option  allows  a  user  to 
turn  a  report  off  that  is  on  by  default.  In  MSMDRP,  all  reports  are  on 
except  report  numbers  12,  16,  18  and  20  (see  table  7-1).  Only  those 
reports  in  table  7-1  that  have  the  HNAME="  designation  can  be  turned  off 
with  this  option.  Two  data  cards  are  required  to  use  this  option.  The 
first  card  contains  the  word  OFF  and  the  second  card  contains  the  name  of 
the  report  as  displayed  in  table  7-1  with  the  "NAME="  designation. 
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7.6.10  Turn  a  Report  On  (Action  Code  ON).  This  option  allows  a  user  to 
turn  a  report  off  that  is  on  by  default.  In  MSMDRP,  all  reports  are  on 
except  report  numbers  12,  16,  18  and  20  (see  table  7-1).  Only  those 
reports  in  table  7-1  that  have  the  "NAME="  designation  can  be  turned  on 
with  this  option.  Two  data  cards  are  required  to  use  this  option.  The 
first  card  contains  the  word  ON  and  the  second  card  contains  the  name  of 
the  report  as  displayed  in  table  7-1  with  the  "NAME="  designation. 

7.6.11  Produce  Connect  Sunnary  Report  by  Userid/SNUMB  (Action  Code  PROJ). 
Thi s  option  allows  the  user  to  specify  up  to  a  total  of  40  USER  lbs  and 
SNUMBs  for  which  he  wants  the  Connect  Summary  Report  by  Userid/SNUMB 
produced.  The  number  of  SNUMBs  requested  cannot  exceed  10.  In  addition, 
since  the  File  Code  Summary  Report  can  result  in  a  large  amount  of  output, 
the  user  may  want  to  see  the  File  Code  Summary  Report  only  for  a 
prespecified  set  of  jobs  or  USERIOs.  For  example,  the  user  can  request  35 
different  USER  IDs  and  5  SNUMBs  or  40  different  USERIDs  and  0  SNUMBs  or  30 
different  USERIDs  and  10  SNUMBs  or  3  different  USERIDs  and  6  SNUMBs,  etc. 
The  format  for  this  option  is  shown  in  figure  7-26.  If  values  of  zero  are 
desired,  they  must  be  punched  on  the  card.  A  blank  is  not  equivalent  to  a 
zero.  In  addition  to  producing  a  limited  File  Code  Summary  Report,  a 
Connect  Summary  Report  is  also  produced.  This  summary  report  will  indicate 
for  each  requested  USERID  or  SNUMB  the  number  of  connects  made  by  the  job 
or  USERID.  If  a  requested  SNUMB  also  has  a  requested  USERID,  the  number  of 
connects  issued  by  that  job  will  be  reported  twice  in  the  summary  report. 
Refer  to  subsection  7.5.14  for  a  description  of  the  report  to  be  produced 
with  this  option. 

7.6.12  Reduce  WW6.4  Data  or  Process  MSMDRP  on  a  WW6.4  System  (Action 
Code  RN)~  This  option  requires  two  cards.  The  first  card  has  the  letters 
RN  and  the  second  card  one  of  the  following  numbers: 

1  -  WW6.4/2H  system  processing  WW6.4/2H  data 

2  -  WW6.4/2H  system  processing  WW7.2/4JS  data 

3  -  WW7.2/4JS  system  processing  WW6.4/2H  data 

The  default  is  a  WW7.2/4JS  system  with  WW7.2/4JS  data. 

7.6.13  Set  a  Timespan  of  Measurement  (Action  Code  TIME).  The  timespan  of 
data  collection  can  cover  many  hours  of  which  only  a  few  may  be  of 
interest.  This  option  allows  a  user  to  specify  the  timespan  (or  spans)  to 
displayed  in  all  reports.  For  example,  the  user  may  specify  that  he  wants 
to  collect  data  from  0500  to  2200  and  wants  to  display  data  only  from  0900 
to  1700  in  all  reports. 

If  the  entire  reduction  will  have  a  set  timespan,  the  name  "TOTAL"  is 
used.  Histogram  reports  cannot  be  Individually  timespanned.  All  timespans 
of  "other"  reports  will  be  bounded  by  the  overall  report  timespan,  if  one 
will  be  used.  Up  to  five  timespans  for  each  report  type  may  be  specified. 
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Card  1  =  A 
Card  2  =  B  C  0 
Card  3+  =  E 
Card  4+  =  F 

Where 

A  =  The  word  PRCU 

B  =  1  if  Connect  Sunnary  Report  is  desired  and  a  complete  File  Code 
Sunnary  Report  is  wanted 

=  2  if  Connect  Summary  Report  is  desired  and  only  a  partial  File  Code 
Sunnary  Report  is  wanted 
C  =  Number  of  Userids  (30  MAX) 

D  =  Number  of  SNUMBS  (10  MAX) 

E  =  A  total  of  C  Userids  with  one  Userid  per  card 
F  =  A  total  of  D  SNUMBS  separated  by  at  least  one  blank  space. 

All  SNUMBS  should  fit  on  one  card. 


Figure  7-26.  Limited  File  Code  Summary  Input  Card  Format 
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and  they  must  he  serially  ordered.  Names  for  other  reports  may  be  found  in 
table  7-1.  Only  those  reports  in  table  7-1  that  have  the 
NAME=specification  can  be  time  controlled.  If  a  report  does  not  have  this 
specification,  it  cannot  be  time  controlled.  If  the  entire  reduction  is  to 
be  time  spanned,  the  name  that  should  be  entered  on  the  data  card  is 
TOTAL.  The  format  for  this  action  is  given  in  figure  7-27.  All  times  are 
expressed  as  four  character  fields  with  no  intervening  blanks.  Time  is 
based  on  a  24-hour  clock.  If  the  user  wants  to  request  the  time  4:07  he 
must  input  a  "0407". 

If  a  start  time  but  no  stop  time  is  desired,  no  characters  should  be 
entered  after  the  minutes  of  the  start  time.  If  stop  time  is  requested, 
there  must  be  a  start  time  corresponding  to  it. 

The  File  Code  Summary  Report,  the  Activity  Summary  Report  and  the  Device 
Area  File  Code  Reference  Report  are  all  considered  as  a  single  unit  under 
this  option.  Whenever  a  time  frame  is  reached  for  any  of  these  reports, 
all  reports  will  be  spanned.  As  an  example,  suppose  that  the  user 
requested  the  following: 

o  File  Code  Summary  Report  for  1500-1600  and  1700-1800. 
o  Device  Area  File  Code  Reference  Report  for  1530-1730. 
o  Activity  Summary  Report  for  1400-1530 

For  the  above  requests,  the  following  report  spans  would  be  produced: 

o  At  1530,  the  File  Code  Summary  Report  would  be  produced  for  the 
period  1500-1530  and  the  Activity  Sunnary  Report  would  be  produced 
for  the  period  1400-1  530. 

o  At  1600,  the  File  Code  Summary  Report  would  be  produced  for  the 
period  1  530-1600,  and  the  Device  Area  File  Code  Reference  Report 
would  be  produced  for  the  period  1530-1600. 
o  At  1730,  the  File  Code  Summary  Report  would  be  produced  for  the 
period  1700-1730  and  the  Device  Area  File  Code  Reference  Report 
would  be  produced  for  the  period  1600-1730. 
o  Finally,  at  1800,  the  File  Code  Summary  report  would  be  produced 
for  the  period  1730-1800. 

7.6.14  Change  the  Time  Quantum  ^lue  For  the  Chronological  Device 
Utilization  Report  (Action  Code  T IME Q ) .  The  user  can  change  the  time 
quantum  value  used  to  produce  the  Chronological  Device  Utilization  Report 
by  inputting  the  quantum  in  seconds.  The  default  value  is  60  seconds.  Two 
cards  are  required.  The  first  card  contains  the  word  TIMEQ  and  the  second 
card  contains  the  new  quantum  in  seconds. 

7.6.15  Suppress  the  USER  IDs  (Action  Code  USERID) .  The  user  can  suppress 
the  printing  of  USCRIDs  on  the  File  Code  Summary  Report  by  entering  the 
word  USERID  on  a  data  card. 
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1 


Card  1  A 
Card  2  B 

Card  3  C  0  E  F  .  .  . 
Where 


A  =  The  word  TIME 

B  =  Number  of  different  times  appearing 
C,D,E  =  Time  used  to  define  a  timespan. 

separated  from  each  other  by  at 
times  are  considered  to  be  on  a 
expressed  as  a  4-digit  field. 


on  Card  3 

Individual  times  must  be 
least  one  blank  column.  All 
24-hour  clock  and  must  be 


Figure  7-27.  Input  Option  TIME  Card  Format 
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7.6.16  Change  the  Tine  Quantum  Value  for  the  Connect  Per  10  Minute  Report 
(Action  Code_RATEtH) .  The  user  can  change  the  tine  quantun  value  used  to 
produce  the  Connect  Per  10  Minute  Report  by  inputting  the  quantum  in 
seconds.  Two  cards  are  required.  The  first  card  contains  the  word  RATECH 
and  the  second  card  contains  the  new  quantum  in  minutes.  The  default  value 
is  10  minutes. 

7.6.17  Turn  on  the  Cat/File  String  Report  (Action  Code  CAT).  This  option, 
consisting  of  the  word  CAT  on  the  data  card,  will  turn  on  the  Cat/File 
String  Report  (see  subsection  7.5.13). 

7.6.18  Request  the  Connect  Per  10  Minute  Report  for  Specific  User  Job 
(Action  Code  RATFTT  This  option  will  allow  the  user  to  obtain  the  Connect 
Report  for  specific  jobs  as  well  as  for  the  Timesharing  Subsystem  and  the 
Total  System  (see  subsection  7.5.24).  Card  number  1  contains  the  word 
RATE,  card  number  2  the  number  of  jobs  desired,  and  card  number  3  the 
SNUMBs  of  the  jobs  desired.  In  addition  to  the  requested  jobs,  the 
Timesharing  Subsystem  as  well  as  the  Total  System  will  also  be  reported. 

If  the  user  wants  to  obtain  this  report  for  only  Timesharing  and  the  Total 
System,  then  he  simply  needs  to  use  the  "ON"  input  option  using  the  name 
“RATE"  for  the  required  report  ID. 

7.7  JCL 

The  data  reduction  procedures  consist  of  a  single  FORTRAN  program  having  a 
main  level  and  multiple  subroutines. 

A  description  of  the  more  important  JCL  cards  is  presented  below  (see 
figure  7-28). 

The  $:LIMITS  card  should  be  studied  to  meet  user  needs.  The  run  time  (99) 
and  output  limit  (30K)  may  both  need  to  be  altered  as  required  by  the 
duration  of  the  monitoring  run.  The  MSMDRP  requires  55K  of  memory  in  order 
to  execute  plus  an  additional  2K  for  SSA  space.  During  the  initial  loading 
process,  MSMDRP  will  actually  require  68K  of  memory,  but  1  IK  will  be 
released  immediately  upon  loading. 

The  statement: 

$  DATA  I* 

Is  used  to  identify  the  data  cards  that  follow  as  described  in  subsection 
7.6.  At  least  one  data  card  is  required,  that  being  an  "END"  request. 

7.8  Multireel  Processing 

If  more  than  a  single  reel  of  data  has  been  collected,  a  series  of  messages 
will  be  outputted  to  the  console  Informing  the  operator  that  a  new  data 
reel  is  required.  The  following  are  the  messages  produced. 


7-54 


Col  1 
$ 

S 

$ 

$ 

$ 

* 


8  16 

IOENT  1820251/30/3044 
SELECT  B29 1 DPXO /OBJ  EC  T/MSM 

TAPE  01 ,X1D,, 12345 

LIMITS  99,55K,-4K,30K 

DATA  I* 

Data  cards  -  at  least  an  "END"  card  must  be  present 
ENDJOB 


Figure  7-28.  DRP  MSM  JCL 
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a.  DISMOUNT  REEL  #XXXXX  THEN  MOUNT  REEL  NUMBER  YYYYY  ON  11111 


In  this  case,  XXXXX  is  the  old  reel  number,  YYYYY  is  the  new  reel 
number,  and  11111  is  the  tape  drive  ID. 

If  the  operator  fails  to  mount  the  new  tape,  the  above  message 
will  be  repeated  three  times,  after  which  the  program  will 
terminate,  and  all  reports  produced. 

b.  IS  TAPE  XXXXX  MOUNTED  ON  DRIVE  ID  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  tape  number  being  requested  for 
mounting  and  YYYYY  is  the  tape  drive  ID. 

This  message  occurs  when  the  data  reduction  program  finds  the 
wrong  tape  has  been  mounted  (by  comparing  internally  generated 
tape  labels).  If  the  operator  answers  M,  the  nessage  in  (c)  below 
is  produced.  If  the  operator  answers  Y,  the  data  reduction 
program  will  terminate  and  all  reports  will  be  produced.  In  this 
case,  the  data  reduction  program  is  unable  to  process  the  tape. 
Even  though  the  operator  is  mounting  the  correct  tape,  the 
internal  label  on  the  new  tape  does  not  match  that  being  requested 
by  the  old  tape.  The  user  should  check  the  data  collection 
session  to  insure  that  the  operator  did  not  respond  with  an 
incorrect  tape  number  during  multireel  change. 

After  entering  the  Y  or  N,  the  operator  will  need  to  hit  the  EOM 
key  twice  in  order  for  the  response  to  be  transmitted. 

c.  Z  REEL  J.JST  MOUNTED,  DISMOUNT  AND  MOUNT  REEL  XXXXX  ON  11111 

In  this  case,  XXXXX  is  the  new  reel  number,  and  11111  is  the  tape 
drive  ID. 

d.  CAN  TAPE  XXXXX  BE  MOUNTED  ON  DRIVE  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  new  desired  reel  and  YYYYY  is  the  tape 
drive  ID. 

If  the  operator  fails  to  answer  this  message  it  will  be  repeated 
until  he  responds  with  a  "Y"  for  YES  or  "N"  for  NO.  If  he  types 
in  "Y",  then  message  (a)  will  be  repeated.  If  the  types  in  "N", 
then  the  program  will  be  terminated  and  all  reports  will  be 
produced. 

7.9  Tape  Error  Aborts 

During  the  course  of  processing  it  is  possible  that  the  operator  will  be 
required  to  abort  the  data  reduction  program  due  to  an  irrecoverable  tape 
error.  If  such  a  condition  occurs,  the  operator  should  abort  the  job  with 
a  "U"  abort.  This  will  allow  the  data  reduction  program  to  enter  its 
wrap-up  code  processing  and  produce  all  reports  generated  prior  to  the  tape 
error. 
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SECTION  8.  CHANNEL  MONITOR  DATA  REDUCTION  PROGRAM  (CMDRP ) 

8.1.  Introduction 

The  Channel  Monitor  Data  Reduction  Program  (CMDRP)  is  a  FORTRAN  program 
that  sequentially  processes  data  the  Channel  Monitor  and  Mass  Store  Monitor 
collected  and  wrote  on  tape.  CMDRP  produces  a  number  of  reports  depicting 
the  usage  of  the  mass  storage  subsystem  (i.e.,  connect  time)  and  the 
conflicts  being  caused  by  multiple  accesses  to  the  subsystem.  Report 
descriptions  are  presented  in  subsection  8.5. 

When  making  I/O  requests,  system  and  user  programs  are  required  to  provide 
system  software  with  sufficient  information  in  the  request  to  complete  the 
I/O  transaction.  In  the  case  of  mass  store  requests,  a  multiprogram 
environment  will  usually  generate  multiple  requests  for  the  same  I/O 
device,  causing  the  I/O  system  to  create  a  queue  for  the  waiting  requests. 
Since  an  I/O  channel  is  also  a  required  resource  to  complete  the  I/O 
request,  a  channel  queue  may  also  develop  and  become  a  bottleneck  in  the 
I/O  process.  Knowledge  of  any  type  of  queue  in  the  I/O  system  is  needed  to 
determine  if  a  bottleneck  exists  and  if  so,  to  determine  where  it  is.  The 
Channel  Monitor  has  been  developed  to  collect  system  events  which  audit  the 
I/O  request  process  through  the  I/O  system.  Associated  with  the  data 
collection  software  is  an  offline  reduction  program  to  display  the 
collected  data  in  a  meaningful  form.  Using  this  information,  decisions  can 
be  made  concerning  mass  store  configuration  of  channels  and  devices.  In 
addition,  information  is  also  reported  concerning  the  queuing  on  tape 
channels.  This  set  of  reports,  used  in  conjunction  with  those  provided  by 
the  Mass  Store  Monitor  Monitor  Data  Reduction  Program  (see  section  7),  will 
provide  the  user  with  a  complete  picture  of  mass  store  usage.  It  should  be 
noted  that  when  the  Channel  Monitor  is  active,  sufficient  data  is  collected 
to  run  not  only  the  Channel  Monitor  Data  Reduction  Program,  but  also  the 
Mass  Store  Monitor  Data  Reduction  Program.  However,  unless  the  Mass  Store 
Monitor  was  active,  no  reports  will  be  produced  on  SSA  cache  performance, 
FMS  catalog  cache  performance,  or  Cat/File  string  structure  and  accessing 
(see  section  7). 

There  are  two  inputs  to  the  CMDRP.  The  first  is  the  data  tape  produced  by 
the  CM  in  the  General  Monitor  Collector.  The  second  input  is  a  set  of 
report  option  control  cards  used  to  alter  the  reports  in  some  way  other 
than  the  standard  default.  The  various  user  input  options  and  their 
formats  are  described  in  subsection  8.6.  The  actual  reports  produced  by 
CMDRP  are  described  in  subsection  8.5. 

8.2  Data  Collection  Methodology 

The  CM  in  the  General  Monitor  Collector  processes  GCOS  trace  types  4,  7, 
and  22,  which  include  the  following: 


o  Terminate  I/O  event 
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Figure  8-1.  IOH  Configuration 


o  Connect  I/O  to  IOM  event 
o  Link  I/O  to  I/O  chain  event 

The  processing  of  a  type  4  trace  records  all  terminate  I/O  events  generated 
by  Input/Output  Supervisor  (IOS).  The  data  generated  by  the  processing  of 
this  trace  event  is  sufficient  to  provide  the  information  required  by  the 
reduction  program  for  I/O  termination  processing.  The  format  of  the  CM 
generated  record  for  this  trace  event  is  described  in  subsection  5. 4. 6.1. 

The  processing  of  a  type  7  trace  records  all  connect  events  generated  by 
IOS.  Additional  data  are  collected  by  the  monitor  to  be  used  by  both  the 
Channel  and  Mass  Store  Reduction  programs.  These  additional  data  for  the 
Channel  Monitor  include  the  I/O  queue  address  located  in  each  monitored 
program's  SSA.  The  IOM,  channel,  and  device  number  are  also  collected  for 
both  monitors.  The  format  of  the  generated  record  for  this  trace  event  is 
described  in  subsection  5. 4. 3.1. 

The  processing  of  a  type  22  trace  records  all  link  I/O  queue  (i.e.,  I/O 
initiation)  events  generated  by  IOS.  Additional  data  collected  by  the  CM 
include  the  IOM,  channel,  and  device  number.  The  format  of  the  generated 
record  for  this  trace  event  is  described  in  subsection  5. 4. 6. 3. 

8.3  Analytical  Methodology 

Three  GCOS  trace  events  are  used  to  audit  the  I/O  requests  as  they  are 
processed  through  the  I/O  sequence.  These  trace  types  are  type  4,  type  7, 
and  type  22  which  denote  the  occurrence  of  a  terminate  interrupt,  I/O 
connect,  and  start  I/O,  in  the  given  order.  The  collection  of  these  events 
in  the  time  sequence  in  which  they  occur  will  simulate  the  I/O  entries  as 
they  are  queued  to  the  various  resources  of  the  Mass  Store  Subsystem.  This 
simulation  of  the  I/O  sequence  is  executed  by  the  data  reduction  program. 

In  order  to  understand  the  reports  produced  by  the  CMDRP,  the  user  should 
understand  the  I/O  process  as  performed  under  GCOS.  In  the  example  shown 
in  figure  8-1,  channels  8  and  9  of  IOM  A  and  B  are  connected  to  one  set  of 
8  drives.  Channels  10  and  11  of  IOM  A  and  B  are  connected  to  another  set 
of  8  drives.  Each  IOM  can  support  up  to  24  channels  when  describing  a  mass 
store  configuration,  and  both  physical  and  logical  channels  can  be 
described.  A  physical  channel  is  an  actual  channel  over  which  data  may 
travel.  A  logical  channel  is  nothing  more  than  a  buffer  area  which  is  used 
to  set  up  and  store  all  information  required  for  initiation  of  the  actual 
I/O  event.  However,  the  actual  transfer  of  data  cannot  be  performed  until 
a  physical  channel  is  available.  However,  the  establishment  of  logical 
channels  does  allcw  significant  processing  to  occur  prior  to  the  actual 
transfer  of  data.  Both  physical  and  logical  channels  require  the 
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use  of  an  IOM  port.  In  figure  8-1,  channels  8  and  10  on  both  IOMs  are 
physical  channels  while  9  and  11  are  logical.  Every  physical  channel  may 
have  three  other  logical  channels  associated  with  it;  i.e.,  a  total  of  four 
channels. 

A  normal  sequence  of  events  produced  by  a  request  for  I/O  would  be  a  type 
22,  type  7,  and  type  4  event,  in  that  order.  The  trace  type  22  indicates 
an  I/O  request  has  been  issued.  The  order  of  the  channel  numbers,  given  on 
the  crossbar  card  of  the  startup  deck,  determines  the  order  in  which  GCOS 
searches  for  enpty  mailboxes  and  starts  I/Os.  The  first  problem  area 
preventing  effective  I/O  throughput  will  occur  if  two  consecutive  logical 
channel  numbers  on  the  same  PSIA  are  sequentially  in  order  on  the  crossbar 
card.  GCOS,  upon  receiving  an  I/O  request,  will  fill  the  mailboxes  and 
start  the  first  I/O.  However,  a  second  I/O  cannot  be  started  until  the 
first  I/O  is  complete  (data  can  only  travel  over  a  physical  channel,  not  a 
logical  channel ) .  The  crossbar  card  should  be  designed  so  as  to  stagger 
PSIAs. 

The  second  area  preventing  effective  I/O  throughput  is  the  method  in  which 
the  Link  Adapters  (LA)  are  utilized.  Each  PSIA  channel  in  the  MPC  shares  a 
LA  with  another  PSIA  channel.  Each  LA  can  service  only  one  PSIA  at  a 
time.  The  PSIAs  are  paired  as  0-1,  2-3,  etc.  The  crossbar  card  should  be 
designed  so  as  to  prevent  two  I/Os  in  succession  from  going  to  the  same  LA. 

The  following  procedure  should  be  followed  to  determine  if  the  crossbar 
card  is  properly  designed: 

o  List  in  a  vertical  column  the  order  of  the  IQfVchannels  on  the 
crossbar  card. 

o  Analyze  the  MPC  card  of  the  startup  deck  and  next  to  each 

IOM/ channel  written  in  step  1,  write  the  MPC/PSIA  associated  with 
that  channel. 

o  A  problem  exists  if  the  same  MPC/PSIA  numbers  appear 

consecutively.  This  is  an  indication  of  consecutive  logical 
channels  (problem  type  1  above). 

o  An  indication  of  the  Link  Adapter  conflict  is  the  occurrence  of 
two  consecutive  entries  in  the  MPC/PSIA  column  with  the  same  MPC 
number  and  consecutive  PSIA  numbers  ( 0—1 , 2—3 ) . 

The  following  is  an  example  of  the  above  procedure: 

Cross  Bar  Cards 

$  XBAR  IQM-0 rPUB-lQ,IOM-l,PUB-10, 

IOM-2 , PUB-10 , IOM-2 , PUB-1 1 , 

IOM-1 , PUB-1 1 , IOM-O , PUB- 1 1 


$  XBAR  IOM-1, PUB- 14, IOM-O, PUB- 14 

IOM-2 , PUB- 1 4 , IOM-2 , PUB- 1 3 , 

IOM-O , PUB-13, 10I1-1 , PUB-13 

MPC  Cards 

i  MPC-0  PS  I  -2 ,  ICM-0 ,  P  UB- 1 0 ,  PSI  - 1 ,  IOM- 1 ,  PUB- 1 0  , 

PSI-3, IOM-2 , PUB-10 ,PSI-3 , ICM-2 , PUB-1 1 , 
PSI-1,  IOM-1,  ?UB-n,PSI-2,  IOM-O,  PUB-11 

$  MPC-2  PSI -0, IOM-1, PUB-1 4, PSI-2, ICM-0, PUB-14 

PSI-1 , IOM-2 , PUB- 1 4 , PSI - 1 , ICM-2 , PUB- 1 3 
PSI-0 , ICM-0 , PUB-1 3 , PSI-2, IOM-1 , PUB- 13 


Chart 


IOM/ Channel 

MPC/PSIA 

lOM/Channel 

MPC/PSIA 

0-10 

0-2 

1-14 

2-0 

1-10 

0-1 

0-14 

2-2 

2-10 

0-3'.  * 

2-14 

2-1 

2-11 

0-3* 

2-13 

1-1,** 

1-11 

0-1 

0-13 

1-0^ 

0-11 

0-2 

1-13 

1-2 

*  problem  1 
**  problem  2 

The  problems  described  by  the  above  procedures  could  be  solved  by 
redesigning  the  crossbar  cards  in  the  following  manner: 

$  XBAR  IOM-O, PUB-10, IOM-1, PUB-10, 

IOM-2 , PUB-10 , IOM-O , PUB-11 , 

IOM-1 , PUB-1 1 , IOM-2 , PUB-1 1 

$  XBAR  IOM-l,PUB-14, IOM-O, PUB-14, 

IOM-2 , PUB-14 , IOM-1 ,PUB-13 , 

IOM-O , PUB-13 , IOM-2 , PUB-13 

If  the  I/O  request  cannot  be  granted,  because  either  the  channel  or  device 
being  requested  is  currently  busy,  the  request  will  be  queued.  This 
request  will  only  be  serviced  when  both  a  channel  and  device  are  free. 

When  queuing  occurs  for  a  channel,  GCOS  will  indicate  the  request  queued 
over  the  primary  channel.  A  primary  channel  is  that  channel  which  appears 
first  on  the  $XBAR  card,  for  a  given  string  of  devices.  Therefore,  all 
channel  queue  histograms  are  presented  only  for  primary  channels.  However, 
a  queue  on  the  primary  channel  actually  means  that  all  channels,  both 
physical  and  logical,  connected  to  the  desired  device  were  busy.  When  the 
request  is  finally  granted,  a  trace  type  7  is  issued. 
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A  table  is  used  to  hold  the  device  number,  channel  number,  IOM  number,  I/O 
queue  entry  address,  and  the  time  the  T22  trace  event  occurred.  With  the 
occurrence  of  each  T22  event,  the  table  entry  is  filled  to  mark  the  linking 
of  the  I/O  requests.  At  this  time,  the  required  computations  for 
determining  the  channel  and  device  queue  length  are  made.  Channel  queue 
histograms  are  produced  for  both  tape  and  mass  store  devices,  while  device 
queue  histograms  are  produced  only  for  mass  storage  devices.  The  channel 
and  device  queue  time  also  begins  at  this  point  and  will  be  updated  with 
the  occurrence  of  the  trace  7  event  for  this  I/O  request. 

With  the  eventual  occurrence  of  the  trace  7  event  for  the  I/O  request, 
several  updates  are  required  to  the  common  tables.  The  I/O  queue  time  data 
are  generated  for  the  channel  and  device  and  collected  for  the  appropriate 
histograms.  It  should  be  noted  that  it  is  possible  for  a  device  to  show  no 
queuing,  but  yet  will  display  I/O  queue  time  in  its  queue  time  histogram. 
The  reason  for  this  is  that  the  queue  time  histogram  is  reporting  the  time 
difference  between  a  T7  trace  and  a  T22  trace.  The  T7  trace  will  not  be 
issued  until  the  actual  I/O  is  initiated  (i.e.,  a  physical  channel  becomes 
available).  Even  though  a  logical  channel  might  be  availaole,  several 
milliseconds  might  pass  before  a  physical  channel  becomes  available  and  the 
T7  trace  is  generated.  Even  if  a  physical  channel  is  available,  upon  the 
occurrence  of  a  T22  trace,  several  milliseconds  might  pass  before  the 
system  generates  the  T7  event.  This  is  especially  true  on  a  very  busy 
system.  A  connect  queue  entry  is  now  filled  with  data  to  be  used  for  the 
I/O  service  time  histograms.  This  connect  queue  holds  the  IOM,  channel, 
device  number,  and  the  time  of  the  trace  7  event.  The  channel  and  devices 
status  table  entries  are  also  marked  busy  at  this  point.  As  a  confidence 
test,  the  channel  status  is  sensed  at  the  start  of  processing  for  each 
trace  7  event  for  a  nonbusy  status.  If  it  is  busy,  a  lost  interrupt  is 
considered  to  have  occurred  since  it  is  impossible  for  a  connect  to  be 
issued  to  a  busy  device  or  channel.  Device  access  histogram  data  and  an 
IOM  command  execution  count  are  also  generated  at  trace  7  event  time. 

The  next  logical  event  for  the  I/O  process  is  the  termination  interrupt 
originated  by  the  IOM  at  the  I/O  data  transfer  completion.  The  signal  for 
this  event  is  transmitted  by  the  IOM  to  the  processor  through  the  SCU  as  a 
request  for  the  processor  to  service  the  I/O  completion.  The  type  4  trace 
event  contains  the  IOM  number  and  channel  for  I/O  termination.  These  data 
are  used  to  determine  the  I/O  service  time  by  finding  the  time  difference 
of  the  connect  event  and  the  terminate  event.  The  time  difference  is 
collected  and  displayed  in  histogram  form  for  each  mass  store  and  tape 
channel  as  well  as  for  all  mass  store  devices.  The  channel  and  device 
queue  length  are  also  adjusted  at  this  point  to  reflect  the  absence  of  a 
queue  being  serviced  for  this  channel  and  device. 

It  must  be  noted  that  exceptions  to  the  normal  I/O  process  are  to  be 
expected  and  must  be  accounted  for  in  the  reduction  program.  All  the 
exceptions  encountered  so  far  have  been  diagnosed  and  coding  in  the  program 
will  allow  for  exceptions.  Some  of  the  exceptions  include  the  following: 
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o  System  programs  that  avoid  the  T22  trace  by  generating  their  own 
queue  entry  and  by  starting  the  connect  immediately. 

o  System  programs  that  manipulate  the  I/O  priority  by  linking 
themselves  ahead  of  I/O  requests  already  in  the  queue. 

o  I/O  requests  for  device  zero  (MPC)  which  makes  a  channel  busy  but 
not  a  device. 

o  Lost  interrupts  from  an  I/O  connect  which  leave  the  connect  table 
and  status  table  in  an  active  state  forever,  if  not  detected. 

o  Special  controller  commands  which  do  not  involve  the  channel  or 
device. 

8.4  Data  Reduction  Methodology 


The  CMDRP  currently  uses  random  I/O  (File  58)  to  process  histogram  data. 
This  feature  allows  the  CMDRP  to  process  an  unlimited  number  of 
channels/devices  with  a  minor  increase  in  memory  requirements.  As 
delivered,  the  CMDRP  will  process  75  mass  storage  devices  and  40  mass 
storage/tape  channels.  It  will  produce  106  unique  histograms  with  a 
minimum  amount  of  random  I/O.  If  the  number  of  channels  or  devices  is 
insufficient,  the  user  will  need  to  edit  file  B29IDPXO/SOURCE/CM.  The  user 
should  enter  the  edit  subsystem  and  process  the  following  command: 

B  RS : /NRDEVXX=XX7 5/ ; * : /NRDEVXX=XX  New  number  of  devices/ 

B  RS:/NRCHANXX=XX40/;*:/NRCHANXX=XX  New  number  of  channels/ 

For  each  additional  channel  the  size  of  the  program  will  increase  by  55 
words  and  for  each  additional  device  the  program  will  increase  by  25 
words.  In  the  above  edit  the  character  "X"  signifies  a  single  space. 

The  last  variable  that  will  need  to  be  changed  is  RPTCNT.  This  number 
represents  the  total  number  of  histograms  that  will  be  processed  with 
negligible  randan  I/O.  To  calculate  the  total  number  of  histograms  that 
will  be  produced  under  your  configuration,  the  following  formula  should  be 
used. 


(number  of  mass  store  devices) *3  +  (number  of  tape  and  mass  store 
channels  -  both  logical  and  physical)  +  (number  of  tape  and  mass  store 
physical  channels) *2. 

If  this  value  is  less  than  106  no  change  is  required.  If  the  value 
computed  is  greater  than  106,  the  user  may  alter  this  value.  This  will 
help  to  decrease  CPU/IO  time  but  will  increase  storage  by  80  words  for  each 
increment  above  106.  This  tradeoff  between  CPU/IO  time  and  memory  must  be 
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made  at  the  discretion  of  the  user.  In  order  to  change  this  value,  the 
following  edit  function  should  be  performed: 

B  RS : /RPTCNTX= 1 0 G/ ; * : /RPTCNTX=New  value 

As  in  the  earlier  edit  example,  the  character  "X*  should  not  be  typed,  but 
is  being  used  to  represent  a  blank  column.  After  performing  the  above 
edits,  the  user  should  recompile  the  source  program  by  entering  the  card 
subsystem  and  issuing  a  run  command. 

8.5  CMDRP  Output 

Reports  generated  from  the  Channel  Monitor  may  vary  from  one  collection 
period  to  another  due  to  the  difference  in  configuration  of  the  hardware. 
Report  numbers  are  preassigned  to  the  histogram  reports  which  are  hardware 
independent  and  are  dynamically  assigned  to  histograms  which  denote  the 
channel  and  device  uniquely  configured  on  each  IOM. 

The  following  subsections  will  describe  all  reports  produced  by  the  CMDRP 
and  subsection  8.6  will  describe  the  user  input  options. 

8.5.1  System  Configuration  and  Channel  Usage  Report  (File  57).  This 
report  documents  the  system  identification,  configuration,  and  the  date  and 
time  of  the  monitoring  period,  as  well  as  reporting  the  usage  of  all 
configured  I/O  channels.  Figure  8-2  is  an  example  of  this  report.  The 
heading  line  indicates  the  software  version  number  that  corresponds  to  this 
document.  The  version  number  should  be  01-82.  The  first  line  after  the 
heading  provides  the  tape  number (s)  the  report  was  generated  from,  the 
system  identification,  the  date  (in  the  form  year,  month,  and  day  - 
YYMMDD) ,  and  the  start  and  stop  times  (HH:MM:SS)  of  the  MONITORING 
SESSION.  The  next  several  lines  of  output  describe  the  overhead  of  all  GMF 
monitors  that  were  active  during  data  collection.  The  monitor  name  is 
given,  its  CPU  time  in  seconds,  and  its  overhead  as  a  function  of  total 
processor  power.  The  GMF  executive  overhead  is  separated  from  the  actual 
monitors  and  is  listed  as  "EXEC*.  The  monitor  "NAME"  is  an  area  of  code 
within  the  Mass  Store  Monitor  and  even  though  listed  separately  it  is  also 
included  under  the  monitor  "MSM" .  The  monitor  "FMS"  is  also  an  area  of 
code  within  the  Mass  Store  Monitor,  but  in  this  case  it  has  not  been 
included  under  the  monitor  "MSM*. 

Monitor  "CM"  in  this  report  describes  the  processor  overhead  of  subroutine 
T4  (terminate  processing)  and  subroutine  122  (start  I/O  processing). 

Monitor  "MSM"  in  this  report  describes  the  processor  overhead  of  subroutine 
T7  (connect  processing).  Therefore,  if  the  Channel  Monitor  was  active,  but 
the  Mass  Store  Monitor  was  not,  this  report  will  still  list  both  "CM"  and 
"MSM"  as  contributing  to  the  processor  overhead.  The  total  Channel  Monitor 
overhead  will  be  found  by  adding  the  overhead  of  the  "CM"  monitor  to  the 
overhead  of  the  "MSM"  monitor,  to  the  overhead  of  the  "FMS"  monitor. 
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*********************************************************** 


Figure  8-2.  System  Configuration  and  Channel  Usage  Re[x>rt 


If  both  the  Channel  Monitor  and  Mass  Store  Monitor  were  active,  then  the 
combined  overhead  of  both  monitors  can  be  found  as  the  sum  of  "MSM*  +  "CM1 
+  "FMS" . 


For  purposes  of  this  report,  %  overhead  is  computed  as: 

(CPU  TIME  Used  by  Monitor) _ 

(TOTAL  Elapsed  Time )x( Number  of  Processors) 

Following  the  overhead  description  are  three  lines  of  configuration 
information  describing  the  number  of  processors,  IOMs,  and  amount  of  memory 
configured  to  the  system.  In  addition,  the  size  of  GCOS  Hard  Core,  the 
size  of  the  Core  Allocator  and  the  size  of  FILSYS  is  also  presented.  The 
third  line  of  the  configuration  data  indicates  the  number  of  processors 
actually  configured  and  actually  available.  These  numbers  might  be 
different  than  shown  on  the  first  line  due  to  the  assigning  and  releasing 
of  processors.  In  figure  8-2,  we  see  that  one  processor  was  released  for  a 
period  of  time  (i.e.,  CPUs  actually  available  is  equal  to  1.75).  The 
actual  time  that  processors  were  available  or  released  is  indicated  in  the 
status  message  printouts  (see  subsection  8.5.15). 

The  next  portion  of  the  report  documents  the  channel  configuration  by  IOM, 
listing  each  configured  channel  number,  the  device  type  configured  to  that 
channel,  and  the  channel  crossbarring.  The  crossbar  column  shows  those 
channels  that  are  crossbarred  to  the  channel  identified  under  the  channel 
column.  If  SEE  ABCVE  is  found,  the  crossbarring  has  been  displayed  on  a 
preceding  channel.  The  I-CC  format  of  each  channel  description  identifies 
the  IOM  and  the  channel  number  being  discussed.  The  last  column  of  this 
report  displays  the  number  of  all  connect  types  issued  ever  that  channel. 
This  section  will  be  repeated  for  each  IOM  configured  co  the  system. 

Figure  8-2  only  displays  IOM  0  activity.  This  report  is  always  generated 
and  cannot  be  turned  off. 

8.5.2  System  Summary  Report  (File  57).  The  System  Configuration  and 
Channel  Usage  Report  and  the  System  Summary  Report  may  be  used  to  assess 
overall  system  utilization.  Figure  8-3  is  an  exanple  of  the  System  Summary 
Report.  The  first  set  of  lines  shows  the  number  of  connects  to  the 
monitored  mass  storage  subsystems  compared  to  the  total  connects  issued 
(TAPE+DISK)  and  the  connect  rate  per  hour  over  the  subsystem.  Most  systems 
will  show  a  small  number  of  Control  Connects  being  generated  by  the  MPCs 
configured  to  the  system.  These  Control  Connects  will  be  summed  together 
and  listed  as  a  separate  subsystem  line.  Analysis  on  a  Shared  Mass  Storage 
System  shows  the  number  of  MPC  connects  generated  to  be  a  significant 
percentage  of  the  total  connects  generated.  The  final  part  of  this  report 
is  a  list  of  the  caimands  (octal  code  and  mnemonic)  issued  to  the  mass 
storage  subsystem  and  the  count  of  each  issued  during  the  monitoring 
session.  This  report  is  always  generated  and  cannot  be  turned  off. 
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A  well  performing  system,  under  a  heavy  workload,  should  show  a  high 
utilization  of  the  configured  resources.  Figure  8-3  shows  that  the  I/O 
activity  is  predominantly  on  the  (1SU450  subsystem  configured  on  channels  8 
and  9  of  IOM  0  and  1  (see  figure  8-2).  The  MSU450s  are  receiving  51%  of 
all  connects  and,  therefore,  should  be  the  major  area  of  concern.  The 
access  rate  for  every  subsystem  is  reported  on  the  top  of  the  System 
Summary  Report  and  i.  can  be  seen  that  the  MSU450s  have  an  access  rate 
significantly  higher  than  the  other  subsystems.  All  signs  indicate  that  if 
system  throughput  is  being  affected  by  disk  activity,  then  the  MSU450s 
would  be  the  probable  cause  of  such  problems. 

The  next  item  to  check  on  these  two  reports  should  be  the  channel  usage. 

The  two  highest  used  logical  channels  of  any  subsystem  should  be  on  a 
separate  PSIA  channel  of  a  two-PSIA  channel  subsystem  (see  subsection 
8.3).  Referring  to  figure  8-2,  one  can  see  that  logical  channel  8  of  IOM  0 
and  IOM  1  has  the  highest  usage,  and  this  is  the  proper  configuration 
(refer  to  detailed  description  in  subsection  8.3).  If  the  highest  used 
logical  channels  are  not  on  separate  PSIA  channels,  the  $  XBAR  card  in  the 
startup  configuration  section  is  suspected  as  the  cause.  The  channels  are 
used  in  the  order  given  on  the  $  XBAR  card  (i.e.,  if  the  primary  channel  is 
busy,  the  next  channel  tried  is  given  on  the  crossbar).  The  alternate  use 
of  PSIA  channels  for  maximum  simultaneity  must,  therefore,  be  appropriately 
specified  in  the  boot  deck. 

While  looking  at  the  System  Summary  Report,  it  is  also  of  interest  to  note 
the  ratio  of  READ  commands  to  WRITE  consnands  (over  two  to  one  in  this 
example).  This  gives  an  indication  of  the  nature  of  the  usage  of  the  mass 
storage  space.  A  quick  look  at  the  number  of  write/verify  (WR-VER) 
commands  executed  is  also  of  interest  as  they  are  essentially  double 
(WRITE,  then  READ)  data  transfer  commands  which  require  more  device  and 
channel  time. 

The  general  fraction  of  utilization  for  each  logical  channel  gives  an 
indication  of  the  degree  of  simultaneity  of  access  to  the  subsystem.  If 
only  N  of  the  configured  logical  channels  have  nonzero  counts,  tnen  there 
were  never  more  than  N  accesses  being  performed  simultaneously  by  the 
subsystem.  The  proportional  relationships  among  the  counts  of  accesses 
made  over  each  of  the  logical  channels  are  quantitative  indications  of  the 
frequency  of  occurrence  of  specific  levels  of  simultaneity.  As  an  example, 
if  we  look  at  figure  8-2,  we  see  that  only  4487  connects  out  a  total  of 
107,273  connects  went  to  Channel  9,  IOM  1.  This  means  that  only  4487  times 
during  the  measuring  period  were  all  four  MSU450  disk  channels  being 
utilized  simultaneously.  In  this  example,  channel  queuing  (i.e.,  shortage 
of  channel  power)  would  not  appear  to  be  a  problem.  This  is  not  to  infer 
that  device  queuing  is  not  a  problem,  just  that  channel  queuing  does  not 
appear  to  be  a  problem.  If  the  number  of  accesses  to  the  lowest  priority 
channel  is  a  larger  percentage  of  the  total  accesses,  them  channel  queuing 
needs  to  be  examined. 
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8.5.3  System  Traces  Captured  by  Monitor  Report  (File  57).  This  report 
contains  the  number  of  occurrences  of  each  specific  trace  type  recorded  on 
the  data  collector  tape  processed  by  the  CMDPP  (figure  8-4).  This  report 
provides  little,  if  any,  information  required  by  the  user  for  his 
analysis.  This  report  is  always  generated  and  cannot  be  turned  off. 

8.5.4  Channel  Status  Changes  Report  (File  57).  This  report  lists  the 
initial  status  for  all  tape  and  disk  channels  configured  to  the  system 
(figure  3-5).  If,  during  the  course  of  the  monitoring  session,  a  given 
channel  or  IOM  was  dropped  or  added  to  the  system  (dynamic  reconfiguration) 
a  new  report  will  be  produced  indicating  the  activation  or  deactivation 
changes  and  the  time  that  the  change  occurred.  Finally,  this  report  will 
indicate  whether  the  SSA  cache  option  and  FMS  cache  option  are  active,  and 
if  so,  will  indicate  their  initial  status  and  any  changes  that  occur  to 
that  status.  If  a  given  option  is  not  active,  a  zero  will  be  reported  for 
each  of  the  values.  This  report  is  always  generated  and  cannot  be  turned 
off. 

8.5.5  Physical  Device,  Device  ID  Correlation  Table  (File  57).  Each  mass 
storage  device  configured  in  the  system  is  listed  with  a  unique  device  ID. 

A  typical  report  is  presented  in  figure  8-6.  This  unique  device  is  needed 
since  different  devices  can  have  the  same  device  number  on  the  Honeywell 
6000.  (See  Device  ID  1,  Device  ID  7,  and  Device  ID  18  of  figure  8-6). 

These  unique  numbers  are  referenced  in  several  reports  produced  by  the 
CMDRP.  This  report  is  always  generated  and  cannot  be  turned  off. 

8.5.6  Channel  Statistics  Report  (File  57).  The  Channel  Statistics  Report 
is  actually  a  series  of  reports  used  to  summarize  the  queuing  that  occurred 
over  the  channels  and  devices.  These  reports  are  processed  as  a  group  and 
are  produced  by  default.  The  entire  series  of  reports  can  be  turned  off 
via  the  use  of  the  "OFF"  input  option  (see  subsection  8.6.5). 

8. 5. 6.1  Channel  Busy  and  Device  Busy  Report.  The  Channel  Busy  and  Device 
Busy  Report  is  given  in  figure  8-7.  These  data  are  collected  into  an  array 
during  execution  of  the  reduction  program  and  indicates  the  number  of  times 
channel  K  and  device  N  were  both  busy  at  the  I/O  request  link  time. 

Remember  that  this  report  is  presented  by  primary  channel.  The  primary 
channel  is  busy  when  all  logical  channels  associated  with  the  primary 
channel  are  busy. 

8. 5. 6. 2  Channel  Busy  and  Device  Free  Report.  The  Channel  Busy  and  Device 
Free  Report,  figure  8-8,  is  generated  in  a  similar  method  to  the  Channel 
Busy  and  Device  Busy  Report .  If  a  channel  is  busy  a  sufficient  number  of 
times,  this  will  indicate  the  need  for  more  channel  power.  If,  for 
example,  there  are  no  more  IOM  ports  available,  a  large  amount  of  channel 
queuing  can  be  a  strong  indication  of  the  need  for  another  IOM. 

8. 5. 6. 3  Channel  Free  and  Device  Busy  Report.  The  Channel  Free  and  Device 
Busy  Report,  figure  8-9,  is  generated  in  a  similar  manner  to  the  previous 
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CHANNEL  STATUS  CHANGES  REPORT  FOR  NMCC2  ON  80/09/20 
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Figure  8-5.  Channel  Status  Changes  Report 


THE  PHYSICAL  DEVICE,  DEVICE  ID  CORRELATION  TABLE 
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CHANNEL  BUSY  AND  DEVICE  BUSY  REPORT  FOR  NMCC2  ON  80-10-06 
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Figure  8-7.  Channel  Busy  and  Device  Busy  Report 


8-17 
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Channel  Free  and  Device  Busy  Report 


two  reports.  It  is  an  indication  of  the  number  of  times  that  an  I/O 
request  was  queued  because  the  device  was  busy  but  there  were  available 
channels.  Significant  values  in  this  report  would  be  an  indication  that 
possible  relocation  of  files  is  required.  The  Mass  Store  Monitor  can  be 
used  with  this  data  tape  to  determine  the  files  being  accessed  on  this 
device. 


8. 5. 6. 4  Channel  Free  and  Device  Free  Report.  The  Channel  Free  and  Device 
Free  Report,  figure  8-10,  is  an  indication  of  the  number  of  I/O  requests 
that  were  executed  by  IOS  immediately,  without  any  queuing. 

8. 5. 6. 5  GEPR  Connect  Report.  The  GEPR  Connect  Report,  figure  8-11,  shows 
the  number  of  times  that  a  trace  type  7  was  processed,  without  a  preceding 
trace  type  22.  This  unexpected  sequence  of  traces  is  supposed  to  occur 
whenever  the  system  processes  a  GEPR  (I/O  error)  event.  During  data 
collection,  the  CM  captures  an  I/O  status  word  indicator  and  the  data 
reduction  program  checks  this  status  word  to  verify  that  a  GEPR  has 
actually  occurred.  This  report  will  indicate  how  many  confirmed  GEPRs 
(i.e.,  the  status  word  was  set)  have  occurred  and  how  many  suspected  GEPRs 
have  occurred  (i.e.,  the  status  word  was  not  set).  This  report  will  be  of 
little  aid  to  the  analyst  and  CCTC  is  still  investigating  the  reason  for 
this  trace  occurrence,  when  the  status  word  is  not  set. 

8. 5. 6. 6  Lost  Interrupt  Report .  The  Lost  Interrupt  Report,  figure  8-12, 
indicates  that  a  trace  type  7  is  being  processed  for  a  busy  device  and/or 
channel.  This  is  an  inpossible  event  and  is  an  indication  that  a  trace 
type  4  has  not  been  generated.  This  is  usually  an  indication  that  the 
system  has  generated  a  lost  interrupt.  However,  if  lost  data  has  been 
generated  during  data  collection,  this  report  may  indicate  many  lost 
interrupts,  which  really  did  not  occur. 

8. 5. 6. 7  Device  ID  STIOS  Not  Connected  Report.  The  Device  ID  STIQS  Not 
Connected  Report,  figure  8-13,  shows  the  number  of  start  I/Os  that  were 
dropped  for  each  device.  A  start  I/O  is  dropped  when  it  is  found  that  a 
STIO  trace  has  occurred  for  a  device  and  within  a  user-defined  timeframe 
(5-second  default),  no  connect  has  been  received  for  the  start.  The  cause 
of  this  condition  currently  is  under  analysis.  This  report  is  also 
presented  by  the  device  ID  and  must  be  correlated  by  using  the  Device  ID 
Correlation  Report. 

9 

8. 5. 6. 8  Entries  Still  in  Queue  Report.  The  Entries  Still  in  Queue  Report, 
figure  8-14,  shows  all  entries  remaining  in  the  CMDRP  queues.  This  report 
shows  the  device  number,  channel  number,  IOM  number,  queue  location,  and 
time  (in  milliseconds)  the  entry  has  been  in  the  queue.  These  entries  were 
active  when  the  monitor  terminated. 

8.5.7  Idle  Monitor  Report  (File  57).  If  the  Idle  Monitor  was  active  when 
the  Channel  Monitor  was  running  an  Idle  Report  will  be  produced  next  (see 
figure  8-15).  The  first  few  lines  will  indicate,  for  each  processor,  the 
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Figure  8-10.  Channel  Free  and  Device  Free  Report 
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number  of  times  that  processor  went  idle  and  the  percent  idleness  of  the 
that  processor.  This  is  followed  by  an  average  idle  percentage  for  the 
entire  system.  The  next  line  of  output  indicates  for  what  percentage  of 
system  idle  time  there  was  active  disk  I/O;  i.e.,  I/O  in  progress  or  I/O 
request  queued.  This  figure  would  give  a  good  indication  as  to  whether  the 
CPU  is  going  idle  because  of  a  lack  of  work  or  rather  because  work  is  being 
delayed  by  the  slower  peripheral  devices.  In  figure  8-15,  we  see  that  for 
100  percent  of  the  idle  time,  the  CPU  was  actually  waiting  on  disk  I/O  to 
be  performed.  In  this  case,  the  CPU  could  be  put  to  better  utilization,  if 
only  the  speed  of  the  disk  subsystem  could  be  increased.  The  next  line  of 
output  indicates  how  many  outstanding  I/Os  were  present  when  the  system 
went  idle. 

Following  this  output,  a  table  is  generated  for  every  disk  device  that  had 
any  active  I/O  on  it  when  the  CPU  went  idle.  For  each  such  device,  the 
percent  of  Idle  Time  during  which  it  had  active  I/O  and  the  average  queue 
size  at  that  time  is  given.  In  figure  8-15,  we  see  that  during  95  percent 
of  CPU  idle  time  device  ID  #1  had  outstanding  I/O  to  an  average  length  of 
4.66.  Device  #4  had  active  I/O  for  46  percent  of  the  CPU  idle  time  with  an 
average  length  of  1.2.  By  examining  this  report,  we  can  see  that  if  the 
queues  on  these  two  devices  could  be  reduced  there  is  sufficient  CPU  power 
available  to  handle  the  additional  workload  that  would  be  generated.  As 
with  earlier  reports,  the  Device  ID  Correlation  Report  should  be  used  to 
convert  a  unique  device  ID  into  an  IOM,  PUB,  device  number. 

8.5.8  Proportionate  Device  Utilization  Report  (File  57).  This  report 
shows  the  proportionate  utilization  of  each  device  configured  on  the  mass 
storage  subsystem.  Figure  8-16  is  an  exanple.  This  histogram  identifies 
each  unique  device  ID  (device  number  zero  is  an  MPC  controller )  and 
provides  both  a  count  of  the  number  of  accesses  made  to  each  device  (under 
the  column  headed  INDIV.  NUMBER)  as  well  as  the  percent  of  all  accesses 
which  were  to  each  device  (under  the  column  headed  INDIV.  PRC).  The 
histogram  shows  the  proportionate  utilization  of  each  device  (i.e.,  the 
percent  of  all  accesses  which  went  to  each  device)  in  a  graphical  form. 

The  physical  device  that  each  "Device  ID"  of  the  histogram  represents  is 
shown  in  the  Physical  Device  ID  Correlation  Table  (see  figure  8-6).  This 
report  is  always  generated  and  cannot  be  turned  off.  In  this  report  the 
user  is  looking  for  a  device  or  devices  which  have  significantly  more 
utilization  than  others  in  the  system.  This  highly  used  device  would  then 
be  a  potential  bottleneck. 

It  is  desirable,  but  not  always  practical,  to  have  equal  utilization  for 
each  device.  The  user  should  be  reminded  that  data  in  figure  8-16  is 
cumulative  over  the  monitoring  period.  The  actual  accessing  pattern  could 
have  been  periodic  with  the  following  form;  Many  accesses  to  device  4 
followed  by  many  accesses  to  device  3  followed  by  many  accesses  to  device  2 
followed  by  many  accesses  to  device  1,  etc.  Each  device  could  have  been  a 
bottleneck  for  a  subperiod  of  the  total  monitoring  period.  This  could  also 
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have  been  the  case  if  the  proportionate  utilization  of  each  device  was 
equal.  The  Channel  Monitor  can  be  used  to  uncover  this  cyclic  type  of 
usage.  In  addition,  the  Chronological  Device  utilization  Report  (see 
subsection  7.5.18)  was  designed  to  uncover  this  type  of  problem  by  breaking 
down  device  utilization  over  time,  rather  than  by  utilizing  a  histogram. 
Nevertheless,  when  a  single  or  small  number  of  devices  has  a 
disproportionately  large  share  of  the  accesses,  they  are  potential 
bottlenecks  and  their  usage  should  be  further  analyzed. 

This  report  will  show  all  connects  that  were  issued  to  a  given  device. 

This  includes  all  read/write  connects,  as  well  as  any  command  type  connects 
issued  to  a  given  device. (See  subsection  7.3). 

8.5.9  Queue  Length  and  Queue  Time  Histograms  (File  57).  Figure  8-17  shows 
the  I/O  queue  length  and  queue  time  histograms  for  the  I/O  requests  to 
devices  as  they  are  processed  by  IOS.  These  reports  occur  in  pairs,  one 
pair  for  each  device.  These  reports  are  generated  only  for  mass  store 
devices.  The  first  report  in  the  pair  is  a  length  report  and  the  second  is 
a  time  report.  The  histogram  is  read  in  the  same  manner  as  the 
Proportionate  Device  Utilization  Report.  In  addition  to  individual 
percentages,  cumulative  percentages  are  also  reported.  In  figure  8-17 
(part  2)  we  see  that  99.457%  of  all  requests  have  a  queue  time  of  12  ms  or 
less  while  99.674%  of  all  requests  have  a  queue  time  of  22  ms  or  less.  The 
number  of  entries  in  these  two  reports  might  not  be  equal.  The  first 
report  is  generated  at  the  time  of  the  request.  When  an  I/O  request  is 
made,  an  entry  is  made  to  the  histogram  indicating  the  number  of  requests 
outstanding  or  in  progress  to  this  device.  The  second  report  is  generated 
at  the  time  of  the  actual  connect  and  indicates  the  length  of  time  between 
the  request  and  the  actual  connect.  Since  observations  have  indicated  that 
some  STIOS  are  never  connected,  the  first  report  may  have  a  higher  number 
of  entries  than  the  second.  These  two  reports  can  be  correlated  by 
subtracting  the  number  of  STIOS  not  connected,  for  a  given  device,  from  the 
number  of  entries  in  the  queue  length  histogram.  As  an  example,  in  figure 
8-17  (part  1)  we  have  a  total  of  921  entries.  However,  figure  8-17  (part 
2)  shows  only  920  entries.  If  we  now  check  figure  8-13  for  this  device  (ID 
#10)  we  find  a  total  of  1  entry  reported.  If  this  figure  is  subtracted 
from  921,  the  two  reports  correlate. 

Figure  8-18  shows  the  channel  queue  length  and  queue  time  for  the  I/O  queue 
entries  as  they  are  used  in  the  system  channel  environment.  These 
histograms  will  be  produced  for  both  mass  store  and  tap>e  channels.  Once 
again,  the  number  of  entries  in  these  figures  will  not  correlate  because  of 
STIOS  issued  over  a  given  channel,  and  not  over  a  single  device.  On  the 
system  used  for  generating  the  figures  in  this  document,  devices  8,  10  and 
20  are  configured  on  IOM-O  PUB-12.  If  we  add  all  references  to  these 
devices  (see  figure  8-13),  we  have  a  total  of  2.  In  addition,  if  we  add  in 
references  to  those  devices  from  figure  8-14  (entries  that  are  still  in  the 
queue),  the  two  figures  will  correlate. 
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920  ENIRIES  TOTAL  .  AVERAGE  =  0.18161  VARIANCE  =  5.347  STANDARD  DEVIATION  =  2.312 


Figure  8-18  (Part  2  of  2) 


In  determining  the  length  of  a  channel  queue,  the  following  is  considered: 

o  A  channel  queue  of  length  0  exists  when  there  is  at  least  one 
nonbusy,  primary/logical  channel. 

o  When  all  primary/logical  channels  become  busy,  the  length  of  the 
channel  queue  is  calculated  by  summing  the  length  of  all  device 
queues  on  that  channel. 

o  As  an  example,  assume  we  had  two  channels  configured  with  three 
devices.  If  device  1  became  busy  and  4  more  requests  were  made 
for  that  device,  we  would  have  a  device  queue  of  4  and  a  channel 
queue  of  0.  If  during  the  same  time,  device  2  received  3 
requests,  we  would  generate  a  queue  length  2  for  that  device  but 
the  channel  queue  would  still  remain  at  0.  In  the  situation 
described  thus  far,  device  contention,  not  a  shortage  of  channels, 
is  the  problem.  If  we  now  assume  that  a  connect  was  issued  to 
device  3,  we  have  now  created  a  channel  problem.  There  is  no 
available  channel  for  the  I/O  request.  At  this  point,  a  channel 
queue  of  7  (4  requests  for  device  1+2  requests  for  device  2+1 
request  for  device  3)  would  be  generated.  Thus,  we  see  that 
channel  queues  may  increase  in  a  nonsequential  fashion. 

8.5.10  Service  Time  Histograms  (File  57).  In  all  of  the  device 
histograms,  it  should  be  noted  that  the  name  of  the  device  is  also  given. 

In  figure  8-17,  queuing  statistics  were  presented  for  a  device  with  the 
name  DA4 .  If  an  exchange  took  place  and  the  DA4  disk  pack  was  moved  from 
0-12-04  to  0-12-07,  the  data  reduction  program  will  account  for  that 
exchange  and  any  connects  that  are  made  to  0-12-07  will  be  reported  on  this 
histogram  and  not  to  the  0-12-07  histogram. 

In  the  upper  right-hand  corner  of  the  report,  a  report  number  is 
indicated.  This  report  number  is  used  only  to  distinguish  one  histogram 
from  another  and  in  no  way  indicates  the  device  to  which  the  report 
refers.  In  addition,  report  numbers  may  not  appear  sequentially  and  this 
in  no  way  is  indicative  of  a  problem.  All  histogram  reports  are  always 
generated  and  cannot  be  turned  off. 

Figure  8-19  shows  the  I/O  service  time  histograms  for  each  I/O  channel  and 
device.  Each  histogram  is  given  in  2ms  intervals.  The  I/O  service  time  is 
defined  as  the  time  (in  ms)  from  connect  to  the  time  that  IOS  processes  the 
terminate  interrupt  for  the  I/O  request.  These  histograms  are  generated 
for  both  mass  store  and  tape  channels,  as  well  as  all  mass  store  devices. 

On  the  bottom  line  of  this  report,  an  indication  is  given  as  to  the  percent 
of  total  time  that  this  device  dr  channel  was  busy. 

The  three  device-oriented  histograms,  just  described,  have  entries  placed 
in  them  for  every  connect  issued  to  the  device  (not  just  multicommands  such 
as  seek-read  or  seek-write). 
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8.5.11  Activity  Statistic  Report  (Files  23  and  24).  Figure  8-20  shows  the 
Activity  Statistical  Report  (Parts  1  and  2).  For  each  activity  run  in  the 
system,  Part  1  of  this  report  displays  the  SNUMB,  the  activity  number,  the 
queue  time  (in  .1  sec)  that  the  activity  accumulated  for  tapes  and  disks, 
the  connect  time  (in  .1  sec)  that  the  activity  accumulated  for  tapes  and 
disk,  and  finally,  the  I DENT  and  USERID  of  the  activity.  The  connect  time 
on  this  report  is  computed  by  using  as  the  start  time  the  issuance  of  trace 
7  and  as  the  stop  time  the  issuance  of  a  trace  4.  The  value  output  in  this 
report  may  differ  significantly  from  the  value  output  by  SCF.  In  the 
opinion  of  CCTC  (C751),  the  value  given  by  this  report  more  closely 
approximates  the  true  connect  time  for  an  activity.  Part  2  of  this  report 
gives  the  number  of  connects  issued  to  tape  and  disk  by  each  SNUMB  and 
activity  number,  and  the  average  queue  time  for  each  connect. 

By  using  this  report,  it  is  possible  to  determine  those  activites  which  are 
being  queued  the  most .  By  examining  Mass  Store  Monitor  output  for  these 
activities,  it  could  be  determined  what  files  and  packs  were  referenced  by 
the  activity  and  possibly  some  file  reorganization  could  be  performed. 

System  Schedular  information  for  each  activity  (activity  0)  is  not  reported 
separately.  All  activity  0  data  is  accumulated  and  reported  as  a  single 
entry  under  the  SNUMB  $GENB. 

From  all  the  reports  produced  thus  far,  it  is  still  not  possible  to 
determine  if  particular  jobs  are  in  conflict  with  each  other.  This 
information  would  be  extremely  useful  in  being  able  to  move  conflicting 
program  files  to  different  disk  packs  or  in  scheduling  conflicting  jobs 
during  different  tiroes  of  the  day.  There  is  a  CMDRP  option  that  allows  the 
user  to  obtain  a  Job  Conflict  Report  for  up  to  four  unique  devices  (see 
subsection  8.5.12).  The  user  would  first  determine  those  devices 
displaying  the  largest  degree  of  queuing,  or  those  devices  containing  the 
files  of  the  programs  receiving  the  largest  queue  times  and  rerun  the  CMDRP 
requesting  the  Job  Conflict  Report  option  (see  subsection  8.6.1). 

8.5.12  Job  Conflict  Report  (Files  31,  32,  33,  34).  In  figure  8-21,  we  have 
a  Job  Conflict  Report  for  Device  ID  #10.  The  first  line  of  the  report  will 
give  the  date,  time,  and  system  name  on  which  the  data  was  collected.  A 
separate  report  will  be  produced  for  each  device  requested  by  the  user  with 
the  Device  ID  number  appearing  in  the  upper  right  hand  corner  of  the 
report.  The  first  column  of  the  report  will  list  the  SNUMB/Activity  Number 
of  every  job  that  was  queued  or  caused  some  other  job  to  be  queued  on  this 
particular  device.  The  USERID  and  IDENT  for  this  SNUMB  is  also  reported, 
under  the  column  'QUEUED  BY*  will  appear  a  list  of  SNUMBs  that  caused  such 
a  delay.  For  example,  $CALC  was  delayed  by  $  PALC  1  time  and  by  $  SYOT  1 
time.  Under  the  column  'QUEUED*  will  appear  a  list  of  SNUMBs  that  were 
delayed  by  this  particular  job  and  the  number  of  times  this  delay 
occurred.  Therefore,  $CALC  delayed  $  GENB  1  time  and  itself  just  one 
time.  Anytime  that  a  given  job  has  been  queued  by,  or  queued,  20  different 
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Figure  8-20.  {Part  2  of  2) 


SNUMBs,  it  will  be  dumped  out.  This  dumping  is  due  to  internal  array  size 
restrictions.  When  this  dump  is  performed  a  message  will  be  printed.  Wo 
data  will  be  lost  and  this  job  will  appear  again. 

This  report  allows  the  user  to  identify  exactly  which  programs  are  causing 
the  queuing  on  a  given  device.  The  Mass  Store  Monitor  reports  can  then 
easily  be  used  to  determine  the  program  files  on  this  device  that  are  in 
conflict . 

8.5.13  Special  Job  Processing  Report  by  Device  (Rile  32).  The  user  has 
the  option  of  producing  two  special  reports  that  describe  in  detail  the 
queue  and  service  times  being  obtained  by  Specific  Jobs.  These  reports  can 
be  obtained  by  invoking  the  "JCB"  input  option  (see  subsection  8.6.10).  In 
the  Activity  Statistic  Report  (subsection  8.5.11),  the  total  queue  time  and 
total  service  time  for  every  activity  processed  during  the  session  is 
reported.  In  the  Special  Job  Processing  Report  by  Device,  these  figures 
are  displayed  in  detail  by  device  number.  In  this  way,  it  is  possible  to 
determine  which  device/devices  are  contributing  the  most  to  the  total 
queue/service  times  obtained  by  a  job.  Each  line  of  the  report  (see  figure 
8—22 )  describes  the  service  being  received  by  a  job  (column  1)  for  a 
particular  device  (column  2).  The  device  number  can  be  related  to  a 
particular  disk  drive  by  using  the  Device  ID  Correlation  Report  (figure 
8-6).  If  a  job  references  more  than  25  unique  devices,  only  the  first  25 
devices  referenced  will  be  reported.  Column  3  provides  the  total  queue 
time  in  milliseconds  and  column  5  provides  the  total  service  time  in 
milliseconds.  Column  7  provides  the  total  number  of  connects  issued  by 
this  job  to  this  device. 

Columns  4  and  6  provide  average  queue  and  service  times  (column  3/7  and 
column  5/7  respectively).  The  final  column  indicates  what  percentage  of 
the  job's  total  connects  were  processed  on  this  particular  device. 

8.5.14  Special  Job  Processing  Report  Per  10  Minutes  (File  32).  The  second 
of  the  special  reports  produced  by  the  •JOB"  input  option  is  shown  in 
figure  8-23.  This  report  is  produced  by  default  every  10  minutes  but  the 
user  can  alter  this  time  restriction  by  using  the  "RATE"  option  (see 
subsection  8.6.11).  Figure  8-23  was  produced  at  5-minute  intervals.  This 
report  provides  similar  information  to  that  described  in  subsection  8.5.13 
except  that  it  is  reported  for  the  total  job  activity,  not  broken  down  by 
individual  devices.  This  report  can  be  very  useful  in  tracking  job 
performance  over  time.  Particular  times  of  day  when  queue  time  is 
substantially  higher  than  normal  can  be  identified.  A  correlation  between 
the  Response  Time  of  TS1,  or  HI-TRAX,  over  time  (as  reported  by  the 
Communications  Monitor),  can  be  made  with  this  report.  If  job  performance 
(TS1,  FTS,  TELNET,  HI-TRAX,  etc.)  is  known  to  be  unacceptable  at  certain 
times  of  day,  this  report  can  be  used  to  see  if  the  unacceptable 
performance  was  due  to  excessive  delay  in  the  I/O  subsystem  performance. 
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Figure  8-22.  Special  Job  Processing  Report  By  Device 


Figure  8-23.  Special  Job  Processing  Report  Per  5  Minute  Report 


8.5.15  Special  Processing  Messages.  During  the  course  of  processing, 
several  special  processing  messages  may  be  generated  by  the  CMDRP.  Most  of 
these  are  for  information  purposes  only  and  can  be  ignored  by  the  analyst. 
Following  is  a  list  and  brief  explanation  of  the  most  comnon  messages. 

o  MONITOR  MUM  WAS  ACTIVE  .... 

This  message  is  produced  for  each  monitor  that  was  active  during 
the  monitoring  session. 

o  RUN  BEING  TERMINATED.  DATA  FOR  MONITOR  CM  ...  . 

The  CM  was  not  active  and  so  no  reports  can  be  produced. 

o  PROCESSOR  #N  IS  ( AVAILABLE/RELEASED)  AT  (TIME) 

This  message  will  indicate  the  assignment  or  releasing  of 
processors  and  provides  the  processor  number  involved  as  well  as 
the  time  of  day  the  assignment/releasing  of  processors  occurred. 

O  FOLLOWING  INPUT  OPTIONS  HAVE  BEEN  CHOSEN 

An  echo  print  of  all  nonstandard  input  options  selected  will  be 
produced.  If  any  input  option  is  described  incorrectly,  an  error 
message  will  be  generated  indicating  the  type  of  error  and  the 
card  number  in  error.  The  user  should  correct  the  error  and 
resubmit  the  job  for  processing. 

O  INCREASE  THE  VALUE  OF  NRDEV  .... 

The  number  of  devices  configured  on  the  system  exceed  the  number 
permitted  by  the  program.  See  subsection  8.4  for  action  to  be 
taken . 

o  INCREASE  THE  VALUE  OF  NRCHAN  .... 

The  number  of  channels  configured  on  the  system  exceed  the  number 
permitted  by  the  program.  See  subsection  8.4  for  action  to  be 
taken. 

O  FOR  INFORMATION  ONLY 

This  message  will  then  be  followed  by  several  lines  of  output 
describing  special  record  types  that  have  been  processed,  or 
special  processing  events  that  have  been  executed  by  the  CMDRP. 

In  most  cases,  the  message  can  be  ignored.  Those  messages  that 
are  important,  and  reveal  an  error  in  processing  logic,  will  be 
described  below.  All  other  messages  will  not  be  described. 

O  JULIAN  DATES  ARE  BAD  -  RUN  TERMINATED 

Every  GMF  data  record  is  preceded  by  the  current  Julian  date.  The 
CMDRP  has  found  a  Julian  date  that  does  not  agree  with  the  Julian 
date  found  on  previous  records.  This  can  occur  when  an  old  GMF 
data  tape  is  used  without  degaussing.  Old  data  is  on  the  tape, 
and  if  the  new  data  failed  to  write  an  end  of  file  mark  on  the 
tape  because  of  a  system  crash  or  malfunction,  the  CMDRP,  after 


reaching  the  end  of  the  new  data,  would  attempt  to  process  the  old 
data  without  realizing  that  is  was  old.  The  check  on  the  Julian 
date  prevents  this  from  happening.  The  CMDRP  will  terminate 
cleanly  and  all  reports  will  be  produced. 

O  HAVE  INCREASING  OR  BAD  SEQUENCE  NUMBERS  .... 

or 

BAD  TRACE  RECORD  .... 

A  problem  has  occurred  in  reading  the  data  tape.  If  the  run  is 
reprocessed,  the  error  may  disappear.  If  it  reoccurs,  then  the 
tape  was  generated  with  an  error.  In  most  cases,  the  CMDRP  will 
recover  and  processing  will  not  be  significantly  affected. 

O  PROCESSING  TERMINATED  BY  NXTRECRD  .... 

CMDRP  has  requested  that  the  operator  mount  a  new  tape  and  the 
operator  has  responded  that  he  did  mount  the  new  tape  or  is  unable 
to  mount  the  new  tape,  if  he  has  mounted  the  new  tape,  CMDRP  is 
unable  to  match  the  initial  record  or  the  new  tape  with  the  last 
record  on  the  old  tape.  User  should  check  the  data  collection 
procedure  to  insure  that  correct  tapes  were  mounted  during  the 
data  collection  phase.  CMDRP  will  terminate  cleanly  and  all 
reports  will  be  produced. 

O  . CALL  CCTC  AT . 

A  series  of  messages  may  be  produced  which  indicate  a  severe 
processing  error.  If  these  occur,  the  output  of  the  run  should  be 
considered  suspect  until  further  clarification  is  obtained  from 
CCTC. 

8.6  Default  Option  Alteration 

Most  users  rely  upon  the  standard  CMDRP  report  formats  and  their  default 
values  as  these  suit  a  wide  range  of  needs.  A  capability  to  change  reports 
is  built  into  CMDRP. 

All  inputs  are  free  format  with  the  only  requirement  being  that  if  any 

value  is  to  be  a  zero,  the  user  must  type  the  number  0  on  the  data  card.  A 

zero  value  may  not  be  inputted  as  a  blank.  At  least  one  data  card  is 

required;  that  being  the  word  "END*  punched  on  the  data  card.  The  "END" 

card  must  be  the  last  data  card  inputted  to  the  program.  It  is  used  to 
signify  the  end  of  input,  or  the  fact  that  there  is  no  input  available.  In 
the  Channel  Monitor,  all  reports  except  the  Job  Conflict  Report  (subsection 
8.5.12),  the  Special  Job  Processing  Report  by  Device  (subsection  8.5.13) 
and  the  Special  Job  Processing  Report  Per  10  Minute  Report  (subsection 
8.5.14)  are  produced  unless  explicitly  turned  off.  If  the  Channel 
Statistics  Reports  (subsection  8.5.6)  are  not  desired,  they  may  be  turned 
off  using  the  "OFF  STANDARD’  format.  Individual  reports  cannot  be  turned 
on  or  off  and  individual  histograms  also  cannot  be  turned  on  or  off.  If 
the  Activity  Statistic  Report  (subsection  8.5.11)  is  not  desired  it  may  be 
turned  off,  using  the  "OFF  STATISTICS"  format. 


8.6.1  Job  Device  Conflict  Report  (Action  Code  QDEV).  This  option  allows 
the  user  to  produce  the  Job  Device  Conflict  Report  for  up  to  four  (4) 
different  devices.  If  more  than  four  devices  are  requested,  only  the  first 
four  devices  will  be  analyzed.  The  first  data  card  contains  the  word 
"QDEV*.  The  second  data  card  contains  the  number  of  devices  to  be 
analyzed.  This  value  cannot  exceed  4.  The  third  data  card  contains  a  list 
of  unique  device  IDs,  separated  by  at  least  one  blank.  Hie  unique  device 
IDs  can  be  obtained  from  the  Physical  Device  ID  Correlation  Report. 

8.6.2  Program  Debug  Options.  There  are  several  debug  options  available  to 
the  user,  none  of  which  should  be  selected  unless  the  user  is  very  familiar 
with  the  data  reduction  program.  These  options  produce  large  amounts  of 
output,  useful  only  when  debugging  data  reduction  program/logic  errors. 

8. 6. 2.1  Program  Number  Debug  (Action  Code  DPRG) .  This  will  allow 
debugging  for  a  given  program  number.  Card  1  contains  the  word  "DPRG",  and 
card  2  contains  the  program  number  for  which  debugging  is  to  occur. 

8. 6. 2. 2  Device  Debug  (Action  Code  DDEV) .  This  will  allow  debugging  for  a 
given  unique  device  ID.  Card  1  contains  the  word  "DDEV",  and  card  2 
contains  the  unique  device  ID  for  which  debugging  is  to  occur. 

8. 6. 2. 3  Queue  Location  Debug  (Action  Oode  DQUE) .  This  option  will  allow 
debugging  for  a  given  10  queue  location.  Card  1  contains  the  word  "DQUE", 
and  card  2  contains  the  10  queue  location  for  which  debugging  is  to  occur. 
The  queue  location  is  inputted  as  a  decimal  value. 

8. 6. 2. 4  Random  Access  File  Debug  (Action  Oode  DEBUG) .  This  option  will 
allow  debugging  to  occur  whenever  the  random  file  containing  e:::ess 
histograms  is  read  or  written.  One  data  card  containing  the  ..o:i  "DEBUG" 
is  all  that  is  required. 

8. 6. 2. 5  Channel  Debug  (Action  Oode  DCHN) .  This  option  will  allow 
debugging  to  occur  for  a  given  channel  (ACTCHN).  This  is  not  input  as  an 
actual  channel  number,  but  rather  as  a  relative  channel  number.  Card  1 
contains  the  word  "DCHN",  and  card  2  contains  the  relative  channel  number 
for  which  debugging  is  to  occur. 

8.6.3  Removal  of  Queue  Entries  (Action  Oode  DELTA).  As  explained  in 
subsection  8. 5. 6. 7,  it  is  possible  for  a  T22  trace  to  be  generated  and 
never  followed  by  a  corresponding  T7 -Connect  Trace.  As  long  as  the  T22 
trace  is  active,  it  will  be  considered  as  an  active  I/O  request  and  may 
effect  the  queue  reports  and  histograms.  If  a  connect  trace  has  not 
occurred  within  a  5-second  (default)  time  span,  this  T22  trace  will 
automatically  be  removed  from  the  queue  tables  and  an  entry  will  be  made 
into  the  Device  ID  STIOS  Not  Connected  Report.  This  option  allows  the  user 
to  alter  the  5-second  default  value.  Card  1  contains  the  word  "DELTA",  and 
card  2  contains  the  default  time  inputted  in  milliseconds. 


8.6.4  Set  a  Time span  of  Measurement  (Action  Oode  TIME).  The  time  span  of 
data  collection  can  cover  many  hours,  of  which  only  a  few  may  be  of 
interest. 

This  option  allows  a  user  to  specify  the  timespan  (or  spans)  to  be 
displayed  in  all  reports.  For  exanple,  the  user  may  specify  that  he  wants 
to  collect  data  from  0500  to  2200  and  wants  to  display  data  only  from  0900 
to  1700  in  all  reports.  Up  to  five  time spans  may  be  specified,  and  they 
must  be  serially  ordered.  The  format  for  this  action  is  given  in  figure 
8-24.  All  times  are  expressed  as  four  character  fields  with  no  intervening 
blanks.  Time  is  based  on  a  24-hour  clock.  If  the  user  wants  to  request 
the  time  4:07  he  must  input  a  '0407.*  If  a  start  time  but  no  step  time  is 
desired,  no  characters  should  be  entered  after  the  minutes  of  the  start 
time.  If  a  stop  time  is  requested,  there  must  be  a  start  time 
corresponding  to  it.  Individual  reports  may  not  be  timespanned.  The 
timespans  will  affect  the  entire  set  of  output. 

8.6.5  Turn  a  Report  On/Off  (Action  Oode  ON/OFF)..  These  options  allow  the 
user  to  turn  certain  report  types  on  or  off.  The  report  types  effected  by 
these  options  are  the  Channel  Statistics  Reports  (subsection  8.5.6)  and  the 
Activity  Statistics  Reports  (subsection  8.5.11).  These  reports  are  on  by 
default  and,  therefore,  the  user  should  need  only  to  use  the  OFF  option  if 
these  reports  are  not  desired.  The  ON  option  is  supplied  only  for  purposes 
of  completeness.  The  format  for  this  option  consists  of  the  word  ON  or  OFF 
on  card  1  and  the  word  STANDARD  or  STATISTICS  on  card  2.  The  word  STANDARD 
is  used  to  turn  off  the  Channel  Statistics  Reports  and  the  word  STATISTICS 
is  used  to  turn  off  the  Activity  Statistics  Reports. 

8.6.6  Cbntinue  Data  Reduction  After  an  Input  Option  Error  (Action  Oode 
ERROR) .  This  option  allows  data  reduction  to  continue  when  an  error  has 
been  detected  and  reported  in  an  input  option  request.  The  default  value 
reports  the  error  and  aborts  the  data  reduction  procedures.  The  format  for 
this  option  is  the  word  ERROR  on  the  data  card. 

8.6.7  W6.4/2H  Data  Reduction  (Action  Oode  RN) .  This  option  allows  a  user 
to  process  a  GMF  data  tape  (W6.4/2H  or  W7.2/4JX)  under  a  W6.4/2H  software 
release.  It  consists  of  the  word  RN  on  a  data  card. 

8.6.8  Record  Limitation  by  Connects  (Action  code  NGONN) .  This  option 
allows  a  user  to  process  only  a  specific  number  of  connects.  This  option 
is  especially  useful  if  the  tape  contains  an  error  on  it  and  cannot  be 
conpletely  processed.  Using  this  option,  the  user  can  process  the  tape  or 
tapes  up  to  the  point  where  the  tape  error  exists.  This  option  requires 
two  data  cards.  The  first  data  card  contains  the  word  NOONN  with  the 
second  card  containing  the  number  of  connects  to  be  processed. 

8.6.9  Record  Limitation  by  Records  (Action  Oode  NREC) .  This  option  allows 
a  user  to  process  only  a  specific  number  of  tape  records.  This  option  is 
especially  useful  if  the  tape  contains  an  error  on  it  and  cannot  be 
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Card  1  A 

Card  2  N  M 

Card  3  B  C  D  E  F  . . . 

where 

A  =  the  word  TIME 
N  =  the  word  TOTAL 

M  =  Humber  of  different  times  appearing  on  card  3 
B,C,D,E,F  =  Start  and  stop  times  used  to  define  timespans. 

Times  must  be  separated  by  one  or  more  blanks. 


Figure  8-24. 


Input  Option  TIME  Format 
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completely  processed.  Using  this  option,  the  user  can  process  the  tape  or 
tapes  up  to  the  point  where  the  tape  error  exists.  This  option  requires 
two  data  cards.  Hie  first  data  card  contains  the  word  NREC  with  the  second 
card  containing  the  number  of  tape  records  to  be  processed. 

8.6.10  Special  Job  Processing  Reports  (Action  Code  JOB).  The  Special  Job 
Processing  Report  described  in  subsections  8.5.13  and  8.5.14  can  be 
obtained  with  this  option.  These  reports  will  not  be  produced  unless  this 
option  is  invoked.  The  format  consists  of  three  data  cards.  Card  1 
contains  the  word  JOB,  card  2  contains  the  number  of  special  jobs  to  be 
reported  (not  to  exceed  5),  and  card  3  contains  the  actual  SNUMBs, 
separated  by  at  least  one  blank  column. 

8.6.11  Change  the  Time  Quantum  Value  for  the  Special  Job  Processing  Report 
Per  10  Minutes  (Action  Oode  RATE).  The  user  can  change  the  time  quantum 
value  used  to  produce  the  Special  Job  Processing  Report  Per  10  Minute  by 
inputting  a  new  time  quantum  in  seconds.  Two  cards  are  required.  The 
first  card  contains  the  word  RATE  and  the  second  card  contains  the  new 
quantum  in  minutes.  The  default  value  is  10  minutes. 

8.6.12  END  Card  (Action  Code  END).  This  card  must  be  present  at  all  times 
and  must  be  the  last  data  card  supplied.  It  consists  of  the  word  END  typed 
on  the  card. 

8.7  JCL 

The  data  reduction  procedures  consist  of  a  single  FORTRAN  program  having  a 
main  level  and  multiple  subroutines.  A  description  of  the  more  inportant 
JCL  cards  is  presented  below  (see  figure  8-25). 

The  $  LIMITS  card  should  be  changed  to  meet  the  user  needs.  The  run  time 
(99)  and  output  limit  (30K)  may  both  need  to  be  altered  as  required  by  the 

duration  of  the  monitoring  run.  The  CMDRP  requires  48K  of  memory  in  order 

to  execute  plus  an  additional  2K  for  SSA  space.  During  the  initial  loading 

process,  CMDRP  will  actually  require  60K  of  memory,  but  10K  will  be 

released  immediately  upon  loading. 

The  statement 

$  DATA  I* 


is  used  to  identify  the  data  cards  that  follow  as  described  in  subsection 
8.6.  At  least  one  data  card  is  required,  that  being  an  "END"  request. 

8.8  Multireel  Processing 

If  more  than  a  single  reel  of  data  has  been  collected,  a  series  of  messages 
will  be  outputted  to  the  console  informing  the  operator  that  a  new  data 
reel  is  required.  The  following  are  the  messages  produced. 


wwwwwww 


COL  1 


8 


16 


IDENT 

SELECT 

TAPE 

LIMITS 

DATA 

Data  Cards 
ENDJOB 


1820251/30/3044 
B29IDPXO/OBJECT/CM 
01/X1D, /12345 
99,50K,-4K,30K 
I* 

-  at  least  an  'END*  card  must  be  present 


Figure  8-25.  CMDRP  JCL 
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a.  DISMOUNT  REEL  IXXXXX  THEN  MOUNT  REEL  NUMBER  YYYYY  ON  ZZZZZ 


In  this  case,  XXXXX  is  the  old  reel  number,  YYYYY  is  the  new  reel 
number,  and  ZZZZZ  is  the  tape  drive  ID. 

If  the  operator  fails  to  mount  the  new  tape,  the  above  message 
will  be  repeated  three  times,  after  which  the  program  will 
terminate,  and  all  reports  produced. 

b.  IS  TAPE  XXXXX  MOUNTED  ON  DRIVE  ID  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  tape  number  being  requested  for 
mounting  and  YYYYY  is  the  tape  drive  ID. 

This  message  occurs  when  the  data  reduction  program  finds  the 
wrong  tape  has  been  mounted  (by  comparing  internally  generated 
tape  labels).  If  the  operator  answers  N,  the  message  in  (c)  below 
is  produced.  If  the  operator  answers  Y,  the  data  reduction 
program  will  terminate  and  all  reports  will  be  produced.  In  this 
case,  the  data  reduction  program  is  unable  to  process  the  tape. 
Even  though  the  operator  is  mounting  the  correct  tape,  the 
internal  label  on  the  new  tape  does  not  match  that  being  requested 
by  the  old  tape.  Hie  user  should  check  the  data  collection 
session  to  insure  that  the  operator  did  not  respond  with  an 
incorrect  tape  number  during  multireel  change. 

After  entering  the  Y  or  N,  the  operator  will  need  to  hit  the  EOM 
key  twice  in  order  for  the  response  to  be  transmitted. 

C.  WRONG  REEL  JUST  MOUNTED,  DISMOUNT  AND  MOUNT  REEL  XXXXX  ON  ZZZZZ 

In  this  case,  XXXXX  is  the  new  reel  number,  and  ZZZZZ  is  the  tape 
drive  ID. 

d.  CAN  TAPE  XXXXX  BE  MOUNTED  ON  DRIVE  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  new  desired  reel  and  YYYYY  is  the  tape 
drive  ID. 

If  the  operator  fails  to  answer  this  message  it  will  be  repeated 
until  he  responds  with  a  "Y"  for  YES  or  "N"  for  NO.  If  he  types 
in  "Y",  then  message  (a)  will  be  repeated.  If  he  types  in  "N", 
then  the  program  will  be  terminated  and  all  reports  will  be 
produced . 

8.9  Tape  Error  Aborts 

During  the  course  of  processing  it  is  possible  that  the  operator  will  be 
required  to  abort  the  data  reduction  program  due  to  an  irrecoverable  tape 


8-51 


error.  If  such  a  condition  occurs,  the  operator  should  abort  the  job  with 
a  "U*  abort.  This  will  allow  the  data  reduction  program  to  enter  its 
wrap-up  code  processing  and  produce  all  reports  generated  prior  tc  the  tape 

error. 


SECTION  9.  COH1UNI CATIONS  ANALYSIS  MONITOR  DATA  REDUCTION  PROGRAM 

'{CAMDRP ) . - 


9.1  Introduction 

The  Communications  Analysis  Monitor  Data  Reduction  Program  is  a 
FORTRAN  program  that  sequentially  processes  data  the  Communications 
Analysis  Monitor  collected  and  wrote  on  tape.  CAMDRP  produces  a 
number  of  reports  depicting  the  usage  of  terminals,  the  response  being 
received  by  terminals  and  the  various  DAC  subsystems,  and  a  special 
analysis  report  on  Time  Sharing  Response.  Report  descriptions  are 
presented  in  subsection  9.5. 

There  are  two  inputs  to  the  CAMDRP.  The  first  is  the  data  tape 
produced  by  the  CAM  In  the  General  Monitor  Collector.  The  second  Is  a 
set  of  report  option  control  cards  used  to  alter  the  reports  in  some 
way  other  than  the  standard  default.  The  various  user  input  options 
and  their  formats  are  described  in  subsection  9.6.  The  actual  reports 
produced  by  CMDRP  are  described  in  subsection  9.5. 

9.2  Data  Collection  Methodology 

The  CAM  in  the  General  Monitor  Collector  processes  a  GMF  generated 
trace  type  14  and  collects  information  to  monitor  the  usage  of  the 
entire  terminal  and  DAC  subsystems.  The  information  collected  on  the 
occurrence  of  the  above  trace  enables  the  CAMDRP  to  identify  the  DAC 
Subsystem  Activity,  response  time  being  received  by  both  DAC 
subsystems  and  terminals,  and  the  extent  to  which  any  terminal  is 
being  utilized.  The  method  used  for  generating  the  CAM  traces  is 
described  in  subsection  5.2.6  and  the  formats  for  the  CAM  generated 
records  used  by  the  CAMDRP  are  described  in  subsection  5.4.7. 

9.3  Analytical  Methodology 

All  communications  between  the  H6000  and  an  online  user  is  controlled 
by  the  GCOS  module  .MDNET  {.DNWW  in  W6.4).  This  module  contains  a 
series  of  buffers,  called  mailboxes,  that  are  used  to  store  data 
passing  between  the  datanet  and  the  H6000.  Whenever  either  machine 
wants  to  communicate  with  the  other,  information  is  placed  in  a 
mailbox  and  an  interrupt  is  generated.  The  Communications  Analysis 
Monitor  (CAM)  is  designed  to  examine  the  mailboxes  each  time  they  are 
changed  and  to  generate  a  GMF  trace  type  14.  The  trace  type  14  Is 
used  by  CAMDRP  to  provide  data  transfer  rates,  machine  response  times 
and  user  think  times.  The  data  transfer  rates  are  derived  from  the 
number  of  words  transferred  for  each  interaction.  Machine  response 
time  can  have  multiple  definitions.  One  definition  Is  the  amount  of 
time  from  the  transfer  of  the  first  character  of  data  by  the  user 
(carriage  return)  to  the  first  response  back  to  the  user  from  the 
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system.  This  definition  is  not  precise  in  that  as  soon  as  GCOS 
recognizes  it  has  received  information  from  the  datanet,  a  receipt 
acknowledgement  is  sent  back  to  the  datanet.  This  acknowledgement 
does  not  indicate  any  processing  by  GCOS;  just  receipt  of  the  data. 

A  second  definition  of  response  tine  is  the  sane  start  time  (carriage 
return)  but  the  stoo  tine  is  when  the  user  has  received  his  last  piece 
of  data  before  being  required  to  give  another  response.  This 
definition  also  is  not  precise  in  that  the  system  response  is  not 
complete  until  possibly  a  fu11  screen  of  data  has  been  transmitted. 
This  definition  also  lumps  GCOS  and  subsystem  (TSS,  TRAX)  response 
together.  However,  it  is  felt  that  this  method  is  a  more  realistic 
method  of  response  time  calculation,  and  is  the  method  used  by  CAMDRP. 

User  think  time  is  defined  by  CAM  to  be  the  amount  of  time  from  the 
start  of  data  transmission  to  the  user  until  the  receipt  of  the  first 
character  of  user  response.  This  includes  any  datanet  delay  time 
(monitored  by  the  datanet  monitor)  and  any  user  wasted  time  (coffee 
break,  phone  call,  etc.).  However,  this  is  the  best  definition 
available  with  the  type  of  data  captured  by  the  CAM.  Figure  9-1 
presents  a  pictorial  representation  of  these  definitions. 

9.4  Data  Reduction  Methods 

The  CAMDRP  reads  only  the  trace  type  14  records  and  any  special 
records.  It  ignores  lost  data  records,  which  can  cause  loss  of  some 
logons  and  disconnects.  The  CAMDRP  logs  a  user  onto  a  subsystem  only 
when  "connect  to  slave"  command  is  captured.  This  command  gives  the 
actual  subsystem  the  user  is  connecting  to  (TSS,  TRAX,  etc.).  If, 
when  CAMDRP  first  begins  processing,  a  user  is  found  to  already  be 
logged  onto  the  system  and  no  "connect  to  slave"  command  has  been 
found,  the  user  is  logged  onto  an  "UNKNWN"  subsystem.  This  is  because 
the  "connect  to  slave"  command  is  the  only  time  the  actual  subsystem 
name  is  known. 

If,  during  processing,  a  datanet  is  found  to  have  crashed,  all  users 
connected  to  that  datanet  are  disconnected  by  the  CAMDRP  and  processed 
as  an  end  terminal  session.  If  a  reduction  time  frame  ends,  all  users 
are  disconnected  as  if  their  terminal  session  ended,  and  all  reports 
are  printed. 

9.5  CAMDRP  Output 

The  CAMDRP  produces  a  header  page  and  either  a  355  Mailbox  Report  or 
Statistical  Summary  Reports,  Terminal  Session  Reports,  and  requested 
histograms.  The  following  subsections  will  describe  all  the  reports 
produced  by  the  CAMDRP. 


MACHINE  RESPONSE  TIME 

TIME  FROM  C  TO  0  TO  A 


USER  THINK  TIME 

TIME  FROM  A  TO  B  TO  C 


9-5.1  Header  Page.  The  header  page  contains  the  total  number  of 
records  read,  trace  records  read,  communications  analysis  (type  14) 
trace  entries  read,  and  the  types  and  number  of  communication 
interface  commands  encountered.  The  date  and  time  of  data  analyzed 
are  printed,  along  with  all  the  data  tape  nunbers  processed.  An 
example  of  the  header  page  is  shov/n  in  figure  9-2.  The  version  number 
printed  on  this  report  should  say  01-82. 

9.5.2  Trace  Dumps.  These  reports  are  produced  only  when  specified  by 
the  LIST,  ALL,  or  MAIL  input  options.  These  dumps  include  a  355 
Mailbox  Trace  Dump  (Total  -  option  LIST,  or  Selective  -  option  ALL) 
and  a  Terminal  Mailbox  Dump  (option  MAIL).  These  options  are 
described  in  subsections  9.6.4  and  9.6.8. 

9. 5. 2.1  355  Mailbox  Report-Trace  Dump.  This  report  is  produced  only 

if  the  user  requested  input  option  LIST  or  ALL.  The  Mailbox  Report 
provides  a  formatted  listing  o^  the  individual  communication  mailboxes 
collected  by  the  data  acquisition  program  (CAM).  A  sample  of  this 
output  is  given  in  figure  9-3.  The  report  contains  a  single  mailbox 
per  line,  separated  into  13  fields  wi th  column  headings  for  each  field 
appearing  at  the  top  of  each  new  page.  Column  headings  and  their 
meanings  are  as  follows: 

a.  ID  -  Specifies  the  unique  terminal  ID. 

b.  CMND  -  Specifies  the  category  of  command  from  one  machine  to 
the  other.  This  heading  is  further  explained  in  the  paragraph 
following  this  list. 

c.  OP  -  Specifies  the  detailed  OP  code  within  a  command  category 
requested  of  the  other  machine. 

d.  P  -  Gives  the  DN355  processor  number.  Numbering  starts  with  0. 

e.  LINE  -  Gives  the  logical  line  number  which  is  used  to  reference 
line  tables  in  the  DH355  and  H6000. 

f.  TYPE  -  Shows  the  terminal  type. 

g.  TLY  -  Tally  word  in  H6000  word  units.  On  an  output  data 
transfer,  it  specifies  the  number  of  words  transferred  from  the 
H6000  to  the  DN355  (four  characters  per  word  in  DAC  mode  and 
six  characters  per  word  in  remote  batch  mode).  On  an  input 
data  transfer,  it  specifies  the  maximum  number  of  words  the 
H6000  allows  the  DN355  to  transfer. 

h.  ITLY  -  Input  tally.  This  specifies  the  number  of  words 
actually  input  into  the  H6000  on  an  input  data  transfer.  It 
will  always  be  less  than  or  equal  to  the  TLY. 
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Figure  9-2.  CAMDRP  Header  Page 
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Figure  9-3.  Mailbox  Report 


i.  ST  -  Status  of  the  operation. 

j.  CMT  -  Count  of  the  number  of  meaningful  characters  included  in 
the  next  field  ( I CM ) ;  a  decimal  integer. 

k.  ICM  -  Intercomputer  message  field.  This  is  a  word  in  the 
mailbox  for  storing  extra  data  to  be  passed  to  the  other 
machine.  The  only  information  the  Connunications  Monitor  looks 
at  in  this  v/ord  is  the  name  of  the  slave  (e.g.,  TSS)  to  which  a 
terminal  is  attempting  to  connect  on  a  "connect  to  slave" 
operation  code. 

l.  TOD  -  Elapsed  time  since  the  system  was  booted  in  a  12-digit 
octal  format  with  1/64  millisecond  resolution. 

m.  RTOD  -  Real  tine-of-day;  the  wall  clock  time  in  the  format 
HH:MM:SS,  with  one  millisecond  resolution.  It  is  computed  by 
adding  the  wall  clock  starting  time  (MME  GETIME)  of  the  data 
acquisition  program  to  the  elapsed  time  from  the  first  mailbox 
to  the  current  mailbox. 

The  command  field  specifies  the  category  of  request  between  the  two 
machines.  The  four  most  important  commands  are  as  follows: 

0  RCD  -  READ  command  data 

0  WCD  -  WRITE  command  data 

o  RTX  -  READ  text 

0  WTX  -  WRITE  text. 

RCD  specifies  a  request  from  the  DN355  to  the  H6000,  whereas  WCD  is  a 
request  from  the  H6000  to  the  DN355.  TRX  and  WTX  request  actual  data 
transfers  with  RTX  for  input  and  WTX  for  output. 

If  a  DAC  program  wants  to  communicate  with  a  terminal  connected  to  it, 
the  program  issues  either  an  "output"  request  to  the  system  or  an 
"output  wait  for  input"  request.  When  the  "output"  request  (MME 
GEROUT  03)  is  issued,  the  program  supplies  the  data  to  be  sent  to  the 
terminal  and  the  program  expects  notification  when  the  operation  is 
completed.  First,  a  "WTX  DACOITT"  mailbox  will  appear  at  this 
interface  which  causes  the  output  message  to  be  transferred  from  the 
H6000  to  the  DM355.  After  the  DN355  transmits  the  data  to  the 
terminal,  an  "RCD  SNDOTP"  mailbox  appears  which  informs  the  H6000  that 
the  output  is  completed  and  more  output  may  now  be  sent.  If  this 
program  sends  more  outputs,  this  mailbox  sequence  will  appear 
repeatedly. 
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The  mailbox  sequence  is  different  when  an  "output  wait  for  input"  (M(€ 
GEROUT  04)  is  issued  by  the  program.  The  program  sends  output  and 
wa its  for  the  user  to  enter  his  input.  The  program  may  be  swapped  out 
while  waiting  for  the  input.  First,  a  "WTX  DACOUT"  mailbox  appears 
with  the  same  significance  as  before.  Ho  mailbox  appears  after  the 
output  has  been  completely  transmitted  to  the  terminal.  Only  after 
the  user  has  entered  his  line  and  has  depressed  the  carriage  return 
does  an  “RCD  ACPDIP"  mailbox  appear  at  the  interface.  This  action 
initiates  a  request  for  the  H6000  to  "accept  DAC  input"  from  the 
DN355.  The  DN355  does  not  directly  transfer  the  data  since  it  is  not 
known  to  which  address  the  data  should  be  transferred  or  even  whether 
the  program  is  in  H6000  memory.  Once  GCOS  determines  the  address  to 
which  the  data  should  be  transferred  (swapping  the  program  in,  if 
necessary),  a  third  mailbox,  "RTX  INPACC,"  appears  at  the  interface 
informing  the  DN355  that  the  H6000  will  "accept  input"  and  where  in 
the  H6000  to  move  it.  This  three  mailbox  sequence  is  characteri Stic 
of  the  "output  wait  for  input"  operation. 

In  remote  batch  mode,  a  continuous  stream  of  either  input  or  output  is 
being  transferred.  If  it  is  output,  the  sequence  which  will  be 
repeated  will  be  "MTX  ACCOUT"  followed  by  "RCD  SNDOTP."  The  first 
mailbox  informs  the  DN355  to  transfer  batch  output  from  the  H6000. 

The  second  is  the  DN355  requesting  more  output. 

On  remote  batch  input,  the  repetitive  sequence  is  "RCD  ACPIHP" 
followed  by  "RTX  INPACC."  The  first  is  the  DN355  request  to  the  H6000 
to  accept  batch  input,  and  the  second  is  the  H6000  accepting  it  and 
that  the  transfer  from  DN355  to  H6000  should  be  made. 

The  formatted  device  names  used  by  both  the  formatted  Mailbox  Report 
and  the  Statistical  Summary  Reports  correspond  to  a  two-digit  octal 
field  appearing  in  the  mailbox.  The  octal  codes  and  the  corresponding 
device  names  used  in  the  program  are  shown  in  table  9-1. 

9. 5. 2. 2  Terminal  Mailbox  Dump.  This  report  is  produced  only  if  the 
MAIL  option  is  requested  along  with  either  the  LIST  or  ALL  option. 
Also,  the  CAM  must  have  run  with  the  complete  conmunications  data 
option  (monitoring  of  specific  terminals).  This  report  gives  a  dump, 
in  ASCII,  Octal,  BCD,  or  all  three  of  all  comnuni cation  traffic 
between  the  H6000  and  the  DH355  for  the  specific  terminals  that  were 
monitored.  This  data  will  include  all  SOH  (start  of  header),  CR 
(carriage  return),  LF  (line  feeds),  etc.  For  terminals  with 
upper/lower  case  data,  upper  case  data  will  be  followed  by  a  period 
(i.e.,  T.H.E  is  THE  and  THE  is  the).  This  option  allows  a  user  to 
track  exactly  what  a  terminal  user  is  doing.  CAUTION  -  This  data  may 
be  classified  since  passwords  may  be  printed.  A  sample  figure  is  not 
presented  in  this  document. 
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Table  9-1.  Octal  Codes  and  Device  Nanes  for  the  Mailbox 
and  Statistical  Sunnary  Reports  (Part  1  of  2) 

16  355  Direct  DM355  Link 

17  XXXX17  Reserved  for  the  System 

20  2741  2741  Tel etypewri ter 

21  XXXX21  Reserved  for  the  System 

22  XXXX22  Reserved  for  the  System 

23  RLP300  Remote  Line  Printer 

24  XXXX24  Reserved 

25  MSLINK  Mass  Store  Link 

26  XXXX26  Reserved  for  the  System 

27  XXXX27  Reserved  for  the  System 

30  MRS200  MRS200  Document  Handler 

31  DRD200  DRD200  Document  Handler 

32  DRDDHU  DRD236  or  DHJ 1 604/8/1 2/1 6  Document  Handler 

33-47  Reserved  for  the  System 

50-67  Reserved  for  Test  and  Diagnostics 

61-77  Reserved  for  Customer  Use 

01  XXXX01  Reserved  for  the  System 

02  XXXX02  Reserved  for  the  System 

03  RCT  Remote  Computer  Terminal 

04  TTY  Teleprinter 

05  DNET4  DATANET  760  -  Screen  Size  ■  4  Lines  X  46  Characters 
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Tab! e  9-1 .  (Part  2  of  2  ) 


06 

DflET8 

DATAHET  760  -  Screen  Sire  =  8  Lines  X  46  Characters 

07 

DMET16 

DATAHET  760  -  Screen  Sire  =  16  Lines  X  46  Characters 

10 

DMET26 

DATAHET  760  -  Screen  Size  =  26  Lines  X  46  Characters 

11 

VIP775 

VIP  Series  765/775  -  Screen  Size  =  22  Lines  X  02 
Characters 

VP786W 

VIP  Series  786  (Ml/MCLS)  -  Screen  Size  =  22  Lines  X 

92  Characters 

13 

VIP  12 

VIP  Series  7700  -  Screen  Size  =  12  Lines  X  80 
Characters 

14 

VIP22 

VIP  Series  7700  -  Screen  Size  =  22  Lines  X  46 
Characters 

15 

VP7705 

VIP  Series  7700  -  Screen  Size  =  24  Lines  X  80 
Cha-acters 
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9.5.3  Statistical  Summary  Reports.  These  reports  are  produced  unless 
the  user  specifically  requests  the  355  Mailbox  Report.  The 
Statistical  Summary  Reports  include  DAC  Device  and  Subsystem 
Summaries,  Remote  Batch  Device  Summary,  and  Terminal  ID  Surmary. 

9. 5. 3.1  DAC  Devices  Summary  Report.  The  DAC  Device  Summary  Report 
{shown  in  figure  9-4)  indicates  the  activity  for  each  of  the  different 
DAC  terminal  types  utilized  during  the  data  collection  session.  The 
distinctive  device  types  include  TTYs,  IBM  2741,  and  several 
categories  of  displays  (e.g.,  VIP786W  and  7705).  Also  represented  in 
these  reports  are  devices  which  use  DAC  protocols,  such  as  the 
DN355-DN355  link  implemented  between  the  CCTC  and  AHMCC. 

For  each  DAC  device,  the  following  values  are  reported  in  terns  of 
mean  and  standard  deviation  (where  appropriate) : 

0  Number  of  sessions  collected  -  Munber  of  terninal  sessions 
accumulated  in  this  category. 

0  Session  length  (sec)  -  Time  from  log-on  to  log-off 

0  Input  length  (char)  -  Number  of  characters  in  an  input 

0  Output  length  (char)  -  Number  of  characters  per  output 

o  Number  of  outputs/output  group  -  Number  of  distinct  outputs  in 
consecutive  order  (total  output  length  =  output  length  times 
the  number  of  outputs/output  group) 

0  User  think  time  (sec)  -  Time  fron  start  of  last  output  transfer 
in  output  group  to  end  of  input  transfer 

o  Machine  response  time  (sec)  -  Time  from  end  of  input  transfer 
to  end  of  that  last  output  transfer 

0  Inter-output  time  (sec)  -  Time  from  start  of  previous  output 
transfer  to  start  of  succeeding  output  transfer 

0  Character  rate  (char/sec)  -  Total  number  of  characters 
transferred,  divided  by  the  terminal  session  length. 

0  Number  of  inputs  -  Total  number  of  user  responses  during  the 
time  period. 

0  Average  number  of  inputs  -  Average  number  of  user  responses  per 
session  (number  of  inputs/number  of  sessions  collected) 


0  Number  outputs  -  Total  number  of  system  responses  duri ng  the 
time  period 
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0  Average  number  of  outputs  -  Average  number  of  system  responses 
per  session  (number  of  outputs/nunber  of  sessions  collected 

0  Flag  -  Logical  flags  indicating  any  unusual  conditions  in  this 
category.  Flag  explanations  appear  on  the  printout. 

The  user  should  note  that  summaries  for  the  same  batch  device  with 
different  flags  are  not  mixed.  Thus,  for  example,  there  may  be 
several  summaries  for  RLP  3000  with  the  majority  of  normal  sessions 
reflected  in  one  summary  and  exceptions  in  the  others.  The  exceptions 
imply  conditions  such  as  GMC  starting  its  collection  in  the  middle  of 
some  terminal  session  for  which  the  session  length  cannot  be 
determi ned. 

9. 5. 3. 2  DAC  Subsystem  Summary  Report.  The  DAC  Subsystem  Sumary 
Report  (figure  9-5)  summarizes  the  characteristics  of  users  of  DAC 
subsystems  such  as  TSS  and  TPS.  The  heading  of  each  report  gives  the 
subsystem  utilized.  The  categories  sumarized  are  the  same  as  those 
categories  discussed  in  subsection  9. 5. 3.1. 

Invariably,  a  number  of  the  subsystems  summarized  are  bogus  due  to 
user  typing  errors.  For  example,  the  following  misspellings  of  TSS 
may  appear:  * YSS ' ,  and  'TS'.  These  reports  do  not  imply  that  these 
subsystems  exist,  only  that  some  user  attempted  to  log-on  to  a  system 
with  that  name.  All  users  logged  onto  the  system  prior  to  the  CAM 
starting  will  be  considered  as  logged  onto  subsystem  IJIIKHWN. 

9. 5. 3. 3  Remote  Batch  Device  Summary  Report.  The  Remote  Batch  Device 
Sunnary  Report  profiles  the  devices  using  remote  batch  mode 
communication  protocols  such  as  remote  line  printers  (RLP300)  and 
remote  computers  (RCT)  (figure  9-6). 

For  each  device,  the  following  values  are  reported: 

0  Number  of  jobs  collected  -  Total  number  of  distinct  jobs 
reflected  in  this  report. 

0  Number  of  input  jobs  -  That  part  of  the  total  number  of  jobs 
which  are  input  jobs. 

0  Number  of  output  jobs  -  That  part  of  the  total  number  of  jobs 
which  are  output  jobs.  Certain  RCT  (H716)  reports  contain  jobs 
that  may  be  counted  as  both  input  and  output;  more  detailed 
examination  of  the  raw  data  is  required  to  verify  this 
circumstance. 

0  Job  length  (sec)  -  Time  from  the  first  to  the  last  data 
transfer  for  that  job. 
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Figure  9-6.  Remote  Batch  Device  Summary  Report 


0 


Input  length  (char)  -  Number  of  input  characters  in  distinct 
i nput. 


0  Output  length  (char)  -  Number  of  output  characters  in  distinct 
output. 

0  Input  character  rate  (char/sec)  -  Total  number  of  input 
characters  divided  by  the  job  length. 

0  Output  character  rate  (char/sec)  -  Total  number  of  output 
characters  divided  by  the  job  length. 

0  Flag  -  Logical  flags  denoting  special  conditions.  Flag  values 
are  explained  on  the  report  printout.  Reports  for  the  same 
device,  with  differing  flag  values,  are  maintained  separately. 

9. 5.3.4  Terminal  ID  Sumary  Report.  The  Terminal  ID  Report  (figure 
Q-7 )  summarizes  the  activity  on  a  particular  terminal  over  the  entire 
data  collection  session.  Terminal  IDs  are  unique  and  unchanging  for 
each  terminal  configured  on  a  given  system.  These  terminal  ID 
assignments  are  made  by  the  computer  operations  personnel  and  become 
effective  at  system  boot  time.  At  some  sites  with  multiprocessors, 
the  terminal  ID  assignments  may  be  different,  depending  on  whether  the 
multiple  systems  are  split.  Terminal  IDs  are  two  alphanumeric 
characters  which  correspond  to  the  12-bit  identification,  specified  in 
calls  to  the  system,  used  to  identify  the  terminal  in  which 
communications  are  directed.  Each  terminal  ID  report  is  headed  by 
this  2-character  ID  and  the  device  type  of  that  terminal.  Items 
reported  are  as  follows: 

o  Number  of  sessions  collected  -  Total  number  of  terminal 
sessions  on  that  terminal . 

0  Session  (job)  length  (sec)  -  Length  of  terminal  session  or  job. 

0  Input  length  (char)  -  Length  of  distinct  inputs.  Also  appended 
is  the  conversion  factor,  from  words  to  characters,  obtained 
from  the  mailbox  giving  the  length  in  units  of  H6000  v/ords. 

DAC  uses  ASCII  characters  at  four  characters  per  word  and 
remote  batch  uses  BCI  characters  at  six  characters  per  word. 

0  Output  length  (char)  -  Length  of  distinct  outputs. 

0  Batch  input  character  rate  (char/sec)  -  Total  number  of  input 
characters  in  job  divided  by  job  length. 

0  Batch  output  character  rate  (char/sec)  -  Total  number  of  output 
characters  in  job  divided  by  job  length. 
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o  i?AC  character*  rate  (char/sec)  -  Total  number  of  DAC  characters 
divided  by  terminal  session  length. 

0  User  think  time  (sec)  -  Tine  from  start  of  last  output  transfer 
in  output  group  to  end  of  input  transfer. 

0  flachine  response  tine  (sec)  -  Tine  from  end  of  input  transfer 
to  end  of  the  last  output  transfer. 

0  Inter-output  tine  (sec)  -  Tine  from  start  of  previous  output 
transfer  to  start  of  succeeding  output  transfer. 

0  *,  terminal  usage  -  The  percent  of  the  monitored  tine  this 

terminal  ID  was  active.  Calculated  by  summing  up  the  total 
terminal  connect  tine  and  dividing  by  the  total  session  length. 

0  Number  inputs  -  Total  number  of  user  responses  during  the  time 
period 

0  Average  number  of  inputs  -  Average  nunber  of  user  responses  per 
session  (number  of  inputs/nunber  of  sessions  collected) 

0  Number  of  outputs  -  Total  number  of  system  responses  during  the 
time  period 

0  Average  number  of  outputs  -  Average  number  of  system  responses 
per  session  (number  of  outputs/number  sessions  collected 

0  Flag  -  Logical  flags  explained  in  the  printout 

9.5.4  Delta  Time  Period  Summary  Report.  This  report  (figure  9-8)  is 
used  to  monitor  overall  communication  activity  on  the  system  as  a 
function  of  time.  It  shows  the  total  number  of  characters  input  and 
output,  in  DAC  and  remote  batch  modes,  during  consecutive  time 
periods.  This  report  is  produced  when  the  time  period  to  be  used  is 
specified  using  the  DELTA  input  option  (subsection  9.6.2). 

Up  to  four  DN355$  can  be  configured.  In  multi-DN355  environments, 
this  report  can  show  whether  the  loads  on  the  two  systems  are 
balanced.  These  reports  also  show  the  number  of  different  terminals 
that  were  active  during  each  time  period. 

The  times,  shown  in  the  left  hand  column,  are  24-hour  wall  clock 
times.  Interspersed  in  these  reports  are  messages  reflecting  the 
aborting  or  rebooting  of  either  DN355. 

9.5.5  Histogram  Reports.  These  reports  are  produced  only  if  the  user 
requests  them  with  the  HISTG  input  option  (subsection  9.6.3).  Three 
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histograms  are  produced  for  each  requested  item.  The  three  histograms 
are  Machine  Response  Time,  User  Think  Time,  and  Session  Length.  These 
histograms  are  basically  an  extension  of  the  previous  Statistical 
Sunmary  Reports.  The  histograms  display  the  distribution  of  time 
values  that  were  measured  and  used  to  produce  the  single  number 
average  that  is  reported  in  the  Surmary  Reports.  The  items  for  which 
histograms  can  be  produced  are  subsystems,  device  types,  or  terminal 
IDs.  Up  to  60  histograms  can  be  produced;  i.e.,  three  different 
histograms  for  each  item  requested,  with  a  maximum  of  20  items.  These 
20  items  can  be  distributed  in  any  way  among  the  three  categories 
(subsystems,  terminal  types,  and  terminal  IDs).  Refer  to  figures  9-9 
through  9-11  for  sample  histograms.  A  histogram  is  a  pictorial 
representation  which  shows  the  distribution  observed  for  a  set  of 
measured  values.  Figure  9-9  will  be  used  to  describe  the  procedure 
that  should  be  followed  in  interpreting  these  reports.  Entries  in  the 
column  headed  SECOND  give  the  range  of  times  which  form  each  histogram 
bucket.  The  first  bucket  is  used  to  report  0  measured  values,  with 
all  other  buckets  used  to  represent  a  range  of  values.  The  entries  in 
the  column  headed  INDIV.  NUMBER  give  the  number  of  responses  that  were 
measured  that  fell  within  the  time  range  specified  by  the  SECOND 
column.  In  figure  9-9,  we  observe  that  2421  responses  measured  0 
seconds  in  duration.  Since  the  histogram  is  displaying  integer 
values,  any  response  that  was  less  than  1  second  would  be  reported  as 
a  0  second  response.  It  will  also  be  observed  that  69  responses  fell 
in  the  range  of  16-18  seconds. 

Similarly,  the  columns  headed  INDIV.  PRC  and  CUMUL.  PRC  give  the 
individual  and  cumulative  percentages  of  all  responses  which  were  made 
within  each  time  range.  In  figure  9-9,  we  observe  that  31%  of  all 
responses  were  0  seconds  in  duration,  while  9%  were  between  16-18 
seconds.  At  the  same  time,  it  can  be  observed  (CUMUL.  PRC)  that  94.5% 
of  all  responses  were  measured  at  12  seconds  or  less  and  that  97.1%  of 
all  responses  occurred  in  21  seconds  or  less.  The  graphic  portion  of 
the  display  gives  a  visual  Indication  of  the  percentage  of  responses 
which  were  measured  for  each  set  of  time  ranges. 

The  bottom  of  the  report  provides  a  statistical  summary  of  the  data  in 
the  report.  Statistics  given  include  average,  variance,  and  standard 
deviation.  These  statistics  apply  to  all  data  points  that  were 
measured.  The  statistics  concerning  OUT  OF  RANGE  are  for  those  data 
points  which  fall  outside  the  range  of  the  histogram  (i.e.,  are  larger 
than  the  bucket  range  of  the  last  bucket  displayed  under  the  column 
headed  SECOND).  OUT  OF  RANGE  points  are  Included  in  the  previous 
statistics. 

9.5.6  Response  Time  Limit  Report-  This  report  is  produced  only  if 
the  user  requests  it  with  the  RESP  input  option  (subsection  9.6.6). 
This  report  will  print  out  a  line  of  information  every  time  a  terminal 
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experiences  a  response  tine  greater  than  or  equal  to  the  requested 
1  ini t.  The  information  printed  includes  'erninal  ID,  subsysten  name, 
response  tine  in  seconds,  and  tine  of  day.  Defer  to  figure  9-12. 

9.5.7  User  Think  Tine  Limit  Report.  This  report  is  produced  only  if 
the  user  requests  it  with  the  THINK  input  option  (subsection  9.6.7). 
This  report  will  print  out  a  line  of  information  every  tine  a  terminal 
experiences  a  response  tine  greater  than  or  equal  to  the  requested 

1  ini t-  The  information  pri nted  includes  Terminal  IP,  subsysten  name, 
think  tine  in  seconds,  aid  tine  of  day.  Defer  to  figure  9-12. 

9.5.8  Terminal  Session  and  High  Terminal  Usage  Reports.  The  Terminal 
Session  Report  (figure  9-13)  is  produced  whenever  the  Stati stical 
Summary  Reports  are  requested.  The  report  gives  an  account  of  every 
session  that  occurs  during  the  monitoring  session.  Every  tine  a  user 
logs  off  or  is  logged  off  due  to  a  DM355  abort,  TCALL,  or  monitor 
termination,  an  entry  into  this  report  is  produced.  The  report  gives 
the  Log  On  Time,  Log  Off  Tine,  Terminal  ID,  Subsystem,  Session  Length, 
Response  Time,  §  Inputs,  #  Outputs.  If  a  terminal  was  logged  onto  a 
subsysten  when  CAM  started,  then  there  is  no  way  for  CAM  to  determine 
the  subsystem  being  used  by  the  terminal.  In  this  case,  the  subsystem 
will  be  reported  as  UMKUV/N.  If  a  user  logs  onto  a  subsysten  and  then 
JDAC's  to  a  different  subsystem,  CAM  is  unable  to  determine  this 
switch.  The  entire  user  session  will  be  reported  as  being  on  the 
subsystem  originally  logged  onto.  The  Session  Length  is  given  in 
seconds.  The  Response  Time  is  given  in  seconds  and  is  the  average 
response  tine  over  the  session.  The  #  Inputs  is  the  number  of  input 
requests  sent  by  the  user.  The  #  Outputs  is  the  number  of  output 
response  groups  sent  to  the  user.  This  report  can  help  pinpoint 
excessive  response  tines.  It  can  also  be  used  to  determine  if  a 
terminal  is  logged  onto  the  system  and  is  not  being  used  (low  inputs, 
high  or  low  outputs,  long  session  length). 

The  High  Terminal  Usage  Report  Is  included  as  part  of  the  Terminal 
Session  Report  and  provides  a  list  of  terminals  that  have  been  logged 
on  for  a  specified  percent  (default  75X)  of  the  session.  This  will 
list  terminals  by  ID  and  type,  give  the  percent  of  time  the  terminal 
was  logged  on  and  the  number  of  sessions  during  this  time.  (See 
figure  9-14. ) 

9.5.9  Opcode  Count  Report.  This  report  (figure  9-15)  is  produced 
whenever  the  System  Summary  Reports  are  produced.  This  report  gives  a 
listing  of  all  the  opcodes  that  were  transmitted  between  the  H6000  and 
the  DM355,  and  a  count  of  how  many  of  each  opcode  there  were.  This 
report  is  of  interest  mainly  when  the  following  opcodes  appear: 
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Figure  9-12.  Response  Tlne/User  Think  Tine  Limit  Report 
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TERMINAL 

ID 

TERMINAL 

TYPE 

PERCENT 

UTILIZATION 

NUMBER 

SESSIONS 

AE 

TTY 

90.2 

8.0 

02 

XXXX24 

97.5 

5.0 

01 

XXXX24 

97.5 

5.0 

A8 

VP7705 

100.0 

1.0 

Figure  9-14.  High  Terminal  Usage  Report 
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OPCODE 

DESCRIPTION 

11 

Output  not  available 

16 

Reject  request  (temporary) 

17 

Reject  request  (permanent) 

20 

Terminal  rejected 

no 

Backspace  output 

These  opcodes  indicate  a  delay  in  data  transmission  or  a 
communications  problem.  If  these  opcodes  show  up  consistently,  and  in 
significant  numbers,  a  detailed  analysis  should  be  conducted. 

9.5.10  Response  Time  Report.  This  report  is  produced  whenever  the 
user  sets  the  interval  time  using  the  input  option  RATE  (subsection 
9.6.11).  The  report  shows,  for  each  interval,  the  tine  of  day,  the 
response  time  in  general  (i.e.,  averaged  overall  DAC  subsystems),  and 
the  response  tine  for  Timesharing.  (See  figure  9-16). 

9.5.11  Error  Messages.  The  CAfffiRP  can  produce  multiple  error 
messages  relating  to  the  data  type.  Most  of  these  messages  are 
actually  warning  messages,  which  the  CAMDRP  will  try  to  recover  from 
and  will  continue  to  process. 

The  most  prevalant  error  message  is  the  warning  message  "TERMINAL  ID 
NOT  FOUND."  This  message  usually  occurs  when  a  terminal  has  been 
logged  onto  the  system  prior  to  the  CAM  starting  to  collect  its  data. 
When  the  CAMDRP  tries  to  find  a  particular  user  who  is  receiving  or 
transmitting  data  in  its  tables,  that  user  will  not  be  found  since  the 
CAMDRP  did  not  find  any  log-on  record  for  nin.  :  : s r  is  logged 
onto  the  system  and  the  CAMDRP  corci.Ts  -s  ;.rocass*'  :j. 

The  main  reason  for  the  CAMDRP  to  abnormally  stop  processing  is  the 
error  message  "NO  MORE  ROOM  IN  INDEX  ARRAY."  This  means  that  an 
internal  array  has  been  filled.  This  is  usually  the  terminal  ID 
array.  The  parameter  SMAX  must  be  increased  to  enlarge  the  required 
arrays.  The  current  size  of  SMAX  is  100.  This  can  be  exceeded  if 
there  are  a  large  number  of  users  on  the  system  when  the  CAM  is 
started.  If  a  terminal  is  logged  on  when  the  CAM  is  started,  the 
terminal  is  logged  on  to  subsystem  UNKNWN.  When  this  terminal 
disconnects  and  reconnects,  it  is  now  logged  on  to  a  valid  subsystem 
and  a  different  entry  is  made  as  this  is  now  a  complete  terminal 
session.  All  complete  terminal  sessions  are  collected  in  one  entry, 
but  any  unusual  session  required  a  separate  entry.  All  other  messages 
produced  will  be  self-explanatory.  If  they  do  not  indicate  a  severe 
error,  the  words  "For  Information  only"  wfll  appear  with  the  message. 
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9.6  Default  Option  Alteration 


The  Communication  Analysis  Monitor  Data  Reduction  Program  (CAMDRP) 
uses  the  trace  tape  generated  by  the  GMC  and  user  data  cards  as 
input.  The  user  has  several  optional  inputs.  These  options  include 
Timeframe  Reduction,  Delta  Timeframe,  Histogram,  Trace  Dump,  User 
Think  Time  Limit,  Machine  Response  Time  Limit,  Record  Count 
Limitation,  Terminal  Busy  Limit,  Response  Time  Report  time  frame,  and 
Terminal  Mailbox  Dump.  These  options  are  evoked  by  specifying  an 
input  option  (action  code)  and  any  other  required  inputs  specified  in 
the  following  subsections.  Default  options  are  given  in  subsection 
9.6.13. 

All  inputs  are  free  format  with  the  only  requirement  being  that  if  any 
value  is  to  be  a  zero,  the  user  must  type  the  number  0  on  the  data 
card.  A  zero  value  may  not  be  inputted  as  a  blank.  In  addition,  at 
least  one  data  card  with  the  word  END  specified  is  required. 

9.6.1  Timeframe  Reduction  Report  (Action  Code  TIME).  This  option 
allows  the  user  to  specify  up  to  five  different  consecutive  processing 
timeframes.  For  example,  the  user  may  collect  data  from  0500  to  2200 
hours  and  specify  that  he  wants  to  process  only  1900  to  2000  hours  and 
2100  to  2200  hours.  The  timespans  set  through  this  option  apply  to 
all  report  processing. 

Up  to  five  timespans  may  be  specified  and  they  must  be  chronologically 
ordered.  In  specifying  time  spans,  a  start  time  and  a  stop  time  must 
be  supplied.  If  a  start  time  is  specified,  but  no  stop  time  is 
specified,  there  should  be  no  data  on  the  card  after  the  start  time  is 
specified.  All  times  are  expressed  as  SI  Ml  where  SI  is  an  hour  and  Ml 
is  a  minute.  All  times  are  considered  to  be  on  a  24-hour  clock,  and 
must  be  expressed  as  4-digit  fields  with  no  intervening  blanks.  If 
the  user  wants  to  request  the  time  4:07  he  must  input  a  "0407." 

Figure  9-17  has  the  card  formats  and  an  example. 

9.6.2  Delta  Timeframe  Report  (Action  Code  DELTA).  This  option  allows 
the  user  to  produce  a  report  (subsection  9. $.4)  for  each  DATANET-355 
giving  the  number  of  active  terminals,  input  characters,  and  output 
characters  every  X  seconds  where  X  is  a  user-specified  value.  The 
first  data  card  contains  the  option  name  "DELTA".  The  second  data 
card  contains  the  length  of  the  delta  timeframe  In  seconds  followed  by 
the  word  COMPRESS  or  NO.  This  word  should  be  separated  from  the  time 
by  at  least  one  intervening  blank.  The  word  COMPRESS  is  included  if 
the  user  wants  to  suppress  the  printing  of  lines  with  all  zeros  for 
data  (i.e.,  no  activity  during  this  timeframe),  or  the  word  NO  is 
included  if  the  user  wants  blanks  or  zero  lines  printed. 


9-31 


H2M2 


H.3M3 


_ HI  01410 


CARD  1  TIME 

CARD  2  N 

CARD  3  HIM! 

'■/here 

N  =  Mtinber  of  different  tines  appearing  on  card  3 
HI Ml  =  Time  used  to  define  a  tinespan. 

Individual  tines  must  be  separated  from 
each  other  by  at  least  1  blank  column, 
(see  section  9.6.1 ) 


Figure  9-17.  Card  Format  -  Input  Option  TIME 
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9.6.3  Histogram  Report  (Action  Code  HISTG).  This  option  allows  the 
user  to  get  up  to  20  groups  of  histograms  {subsection  9.5.5).  Each 
group  includes  a  histogram  for  machine  response  time  in  seconds,  user 
think  time  in  seconds,  and  session  length  time  in  minutes. 

These  histograms  can  be  produced  by  subsystem,  device  types,  or 
terminal  ID.  The  user  is  allowed  any  combination  of  these  three 
categories,  with  a  maximum  of  20  total  items.  The  input  option  name 
HISTG  is  used  for  these  histograms.  The  second  data  card  contains  the 
number  of  subsystems  wanted,  number  of  device  types  wanted,  and  number 
of  terminal  IDs  wanted. 

The  next  card(s)  contains  the  subsystem  names,  if  requested.  The 
following  card(s)  contains  the  device  types,  if  requested.  (See  table 
9-2  for  a  list  of  acceptable  device  type  names.)  The  next  card 
contains  up  to  20  two-character  terminal  IDs.  The  format  of  these 
cards  is  shown  in  figure  9-18. 

9.6.4  Trace  Dump  Report  (Action  Code  LIST  or  ALL).  These  options 
allow  the  user  to  get  a  formatted  dump  of  all  CAMDRP  traces.  The 
input  option  name  for  the  Trace  Dump  Report  (subsection  9.5.2)  is 
LIST.  The  input  option  name  for  both  Trace  and  Summary  Report  data 
(subsection  9.5.2)  is  ALL.  If  the  user  wishes  to  limit  the  amount  of 
output,  an  option  exists  to  print  out  only  certain  subsystems, 
terminal  IDs,  or  terminal  types.  This  is  accomplished  by  using  the 
HISTG  input  option  with  the  LIST  input  option.  In  this  case,  no 
histograms  will  be  produced  and  the  trace  dump  will  be  limited  to  the 
requested  terminals,  subsystems,  and  terminal  types.  This  option 
consists  of  a  single  data  card  containing  the  word  LIST  or  ALL. 

9.6.5  Record  Count  Limitation  (Action  Code  NREC).  This  option 
permits  the  user  to  process  only  a  certain  number  of  tape  records. 

The  input  option  name  for  the  Record  Count  Limitation  is  NREC.  The 
second  data  card  contains  the  number  of  tape  records  to  be  read. 

9.6.6  Response  Time  Limit  (Action  Code  RESP).  This  option  permits 
the  user  to  specify  an  acceptable  machine  response  time  in  seconds. 

If  any  terminal  exceeds  or  equals  this  limit,  the  terminal  ID  and 
response  time  are  printed  out  (subsection  9.5.6).  The  format  of  this 
option  is  the  word  RESP  on  the  first  data  card  and  the  response  time 
limit  on  the  second  data  card. 

9.6.7  Think  Time  Limit  (Action  Code  THIHK).  This  option  permits  the 
user  to  specify  an  acceptable  User  Think  Time  in  seconds.  If  any  user 
exceeds  or  equals  this  limit,  the  terminal  ID  and  think  time  are 
printed  out  (subsection  9.5.7).  The  format  of  this  option  is  the  word 
THINK  on  the  first  data  card  and  the  think  time  limit  on  the  second 
data  card. 


Table  9-2.  Acceptable  Device  Type  Hanes 


DEVICE  TYPE 

Remote  Computer 

Teletype 

VIP  775 

VIP  786W 

VIP  12 

VIP  22 

VIP  7705 

2741 

RIP  300 

Mass  Store  Link 
MRS  200  Document 
DRD  200  Document 


CAMDP.P  INPUT 


RCT 

TTY 

VIP775 

VP786W 

VIP12 

VIP22 

VP7705 

2741 

RLP300 

MSLINK 

Handler 

MRS200 

Handler 

DRD200 
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CARD  1  HISTG 

CARD  2  B  C  D 

CARD  3  E  F  G... 

CARD  4  H  I  J... 

CARD  5  K  L  M... 

Where 

B  =  Number  of  subsystems  wanted 

C  =  Humber  of  device  types  v/anted 

D  =  Number  of  terminal  IDs  wanted 

E,F,G  =  Up  to  10  subsystem  names  separated 

by  at  least  one  blank  (may  go  to  more  than  1  card) 

H , I ,J  =  Up  to  10  device  types  separated  by  at 

least  one  blank  (may  go  to  more  than  1  card) 

K,L,M  =  Up  to  20  terminal  IDs  separated  by  at 

least  one  blank 


Figure  9-18.  Histogram  Reports, 
Input  Option  HISTG 
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9.6.8  Terminal  Mailbox  Dump  (Action  Code  MAIL).  This  option  allows 
the  user  to  get  a  dump  of  tne  terminal  traffic  collected  for  the 
specified  terminal  IDs.  (Reference  subsection  9. 5.2.2)  This  output 
can  be  in  ASCII,  BCD,  OCTAL,  or  all  three.  See  figure  9-19  for  the 
format  of  this  option.  NOTE  -  this  option  will  turn  on  the  LIST 
option. 

9.6.9  Terminal  Busy  Limit  (Action  Code  BUSY).  This  option  allows  the 
user  to  change  the  threshold  for  the  High  Terminal  Usage  Report 
(subsection  9.5.8).  Whenever  a  terminal  is  connected  to  the  system 
for  greater  than  the  desired  limit,  the  terminal  ID  will  be  printed. 
Two  cards  are  required  for  this  option.  The  first  card  has  the  word 
BUSY  on  it  and  the  second  card  contains  a  %  busy  limit  value. 

9.6.10  W6.4/2H  Data  Reduction  (Action  Code  RN) .  This  option  allows 
the  user  to  process  a  GMF  data  tape  (W6.4/2H  or  W7.2/4Jx)  under  a 
W6.4/2H  software  release.  It  consists  of  the  letters  RN  on  a  data 
card. 


9.6.11  Response  Time  Report  Time  Frame  (Action  Code  RATE).  This 
option  allows  the  user  to  produce  a  report  (subsection  9.  $.10)  giving 
the  average  response  time  over  a  time  interval  for  both  Timesharing 
and  all  subsystems  combined.  This  option  requires  two  data  cards. 

The  first  card  contains  the  word  RATE  and  the  second  card  contains  the 
number  of  minutes  between  response  time  printouts. 

9.6.12  Terminate  Input  Options  (Action  Code  END).  This  option  is 
required  as  the  last  input  option  data  card.  TFmay  be  the  only  data 
card  if  standard  default  options  are  selected.  It  consists  of  the 
word  END  on  a  data  card. 

9.6.13  Default  Options.  The  default  options  for  the  variable  input 
are  as  follows: 

ACTION 

7EBT~ 


TIME 

DELTA 


HISTG 


Option  Default  Value 

Timeframes  None,  total  tape  processed. 

Delta  Time-  None,  this  report  is  not  processed, 
frames  If  Delta  time  is  given  but  not  the  word 

COMPRESS,  all  data  are  printed.  . 

Histograms  None,  no  histograms  produced. 

Trace  None,  report  data  reduction  is  done, 

not  trace  dump. 


LIST 


Number  of  terminals  to  be  dumped  (1  or  2) 
The  letters  8CD  for  a  BCD  dump 
The  letters  ASCII  for  an  ASCII  dump 
The  letters  OCTAL  for  an  OCTAL  dump 
The  letters  ALL  for  all  three  dumps 
Terminal  ID  =*1 

Terminal  ID  ~2  (present  only  if  N=2) 


Figure  9-19.  Terminal  (tailbox  Dump, 
Input  Option  MAIL 


NREC 

Record  Count 
Li  mi  t 

None,  total  tape  processed 

RESP 

Response 

Time 

Limit 

9999  seconds 

THINK 

User  Think 
Tine  Limit 

9999  seconds 

MAIL 

Terminal 

Mailbox 

Dump 

None,  no  mailbox  dump  is  produced.  Only 
valid  with  specially  collected  data 
tapes. 

BUSY 

Term'  nal 

Busy 

75% 

RM 

Process  on 
WW6.4 

Assumed  CAMDRP  will  be  executed  under  a 
WW7.2/4JS  system 

RATE 

Response 

Report 

Time  Frame 

9999  minutes  (no  reports  printed) 

9.7.  JCL 

Following  is  a  sample  of  the  JCL  required  to  run  CAMDRP.  The  only 
change  required  involves  the  use  of  input  data.  CAMDRP  requires  5 OK 
of  memory  to  process,  but  will  use  65K  during  the  load  procedure. 
Immediately  upon  loading,  the  additional  15K  will  be  released. 

$  IDENT  User  Accounting  Information 

$  USERID  User  Identification/Password/Classification 

$  SELECT  B29IDPX0/0BJECT/CAM 

$  LIMITS  999, 50K,-4K,1  5K 

%  TAPE  01, XI D,, Tape  # 

$  DATA  I* 

DATA  cards 


(at  least  an  "END"  card  must  be  present) 


Multireel  Processing 


If  more  than  a  single  reel  of  data  has  been  collected,  a  series  of 
messages  will  be  outputted  to  the  console 
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informing  the  operator  that  a  new  data  reel  is  required.  The 
following  are  the  messages  produced. 

a.  DISMOUNT  REEL  #XXXXX  THEN  MOUNT  REEL  NUMBER  YYYYY  ON  ZZZZZ 

In  this  case,  XXXXX  is  the  old  reel  number,  YYYYY  is  the  new 
reel  number,  and  ZZZZZ  is  the  tape  drive  ID. 

If  the  operator  fails  to  mount  the  new  tape,  the  above 
message  will  be  repeated  three  times,  after  which  the  program 
will  terminate,  and  all  reports  produced. 

b.  IS  TAPE  XXXXX  MOUNTED  ON  DRIVE  ID  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  tape  number  being  requested  for 
mounting  and  YYYYY  is  the  tape  drive  ID. 

This  message  occurs  when  the  data  reduction  program  finds  the 
wrong  tape  has  been  mounted  (by  comparing  internally 
generated  tape  labels).  If  the  operator  answers  N,  the 
message  in  (c)  below  is  produced.  If  the  operator  answers  Y, 
the  data  reduction  program  will  terminate  and  all  reports 
will  be  produced.  In  this  case,  the  data  reduction  program 
is  unable  to  process  the  tape.  Even  though  the  operator  is 
mounting  the  correct  tape,  the  internal  label  on  the  new  tape 
does  not  match  that  being  requested  by  the  old  tape.  The 
user  should  check  the  data  collection  session  to  insure  that 
the  operator  did  not  respond  with  an  incorrect  tape  number 
during  multireel  change. 

After  entering  the  Y  or  N,  the  operator  will  need  to  hit  the 
EOM  key  twice  in  order  for  the  response  to  be  transmitted. 

C.  WRONG  REEL  JUST  MOUNTED,  DISMOUNT  AND  MOUNT  REEL  XXXXX  ON 
ZZZZZ 

In  this  case,  XXXXX  is  the  new  reel  number,  and  ZZZZZ  is  the 
tape  drive  ID. 

d.  CAN  TAPE  XXXXX  BE  MOUNTED  ON  DRIVE  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  new  desired  reel  and  YYYYY  is  the 
tape  drive  ID. 

If  the  operator  fails  to  answer  this  message  it  will  be 
repeated  until  he  responds  with  a  "Y"  for  YES  or  "N*  for  NO. 
If  he  types  in  *Y*,  then  message  (a)  will  be  repeated,  if 
the  types  in  "N",  then  the  program  will  be  terminated  and  all 
reports  will  be  produced. 
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9.9  Tape  Error  Aborts 


During  the  course  of  processing  it  is  possible  that  the  operator  will 
be  required  to  abort  the  data  reduction  program  due  to  an 
irrecoverable  tape  error.  If  such  a  condition  occurs,  the  operator 
should  abort  the  job  with  a  "U"  abort.  This  will  allow  the  data 
reduction  program  to  enter  its  wrap-up  code  processing  and  produce  all 
reports  generated  prior  to  the  tape  error. 
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SECTION  10 .  DATANET-355  DATA  REDUCTION  PROGRAM  (DDRP) . 


10 . 1  Introduction 

The  DATANET-355  Data  Reduction  Program  (DDRP)  is  a  FORTRAN  program 
that  sequentially  processes  data  the  DATANET-355  GRTS  Monitor 
collected  and  wrote  on  tape.  DDRP  produces  a  number  of  reports 
describing  the  performance  of  the  DATANET-355  front  ends.  CPU  and 
resource  usage,  subchannel  usage,  and  user  response  times  are  but  some 
of  the  many  reports  that  can  be  obtained.  Report  descriptions  are 
presented  in  subsection  10.5. 

There  are  two  inputs  to  the  DDRP.  The  first  is  the  data  tape  produced 
by  the  GRTM  in  the  General  Monitor  Collector.  The  second  is  a  set  of 
report  option  control  cards  used  to  alter  the  reports  in  some  way 
other  than  the  standard  default.  The  various  user  input  options  and 
their  formats  are  described  in  subsection  10.6.  The  actual  reports 
produced  by  DDRP  are  described  in  subsection  10.5. 

10.2  Data  Collection  Methodology 

The  GRTM  in  the  General  Monitor  Collector  processes  a  GMF  generated 
trace  (type  62)  and  collects  information  to  monitor  the  performance  of 
the  DATANET-355  front  ends.  The  performance  information  is  collected 
within  the  DATANET-355  and  transmitted  from  the  DATANET  to  the  GMF 
which  is  resident  in  the  H6000.  Under  normal  operating  conditions, 
the  DATANET-355  does  not  generate  performance  data.  In  order  to 
generate  the  desired  performance  data,  it  is  necessary  to  alter  the 
standard  DATANET-355  CRT  software.  The  method  for  altering  the  GRT 
software  is  described  in  subsection  5. 2. 7. 3.  The  alters  which  must  be 
applied  to  the  GRT  software  not  only  allow  the  DATANET-355  to  generate 
performance  data,  but  also  provide  the  mechanism  by  which  the 
DATANET-355  communicates  with  the  GMF.  This  communication  process  is 
described  in  subsections  5. 2. 7. 4  and  5. 2. 7. 5.  The  format  for  the  GRTM 
generated  records  used  by  the  DDRP  are  described  in  subsection  5.4.8. 

10.3  Analytical  Methodology 

Within  the  GRTS-II  Monitor,  a  series  of  10  different  events  are 
captured  and  the  time  of  their  occurrence  is  recorded.  The  10 
different  events  are  as  follows: 

1.  Connect  time  of  a  terminal. 

2.  DN355  requesting  output  from  the  H6000. 

3.  H6000  telling  the  DN355  to  accept  direct  output. 

4.  H6000  telling  the  DN355  to  accept  direct  output  and  return 
input. 
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5.  DN355  telling  the  H6000  to  accept  input. 

6.  H6000  telling  DN355  that  it  accepted  the  input. 

7.  Disconnect  time  of  a  terminal. 

8.  DN355  has  received  output  from  the  H6000 . 

9.  DN355  has  begun  to  transmit  data  to  a  terminal. 

10.  DN355  has  completed  transmission  of  data  to  a  terminal. 

Using  the  above  events,  seven  different  response  times  are  defined  and 
reported  at  the  DATANET  level  and  for  specified  terminals.  These 
seven  different  response  times  are  as  follows: 

1.  H6000  Data  Acceptance  Time  From  the  DATANET  (Event  6  -  Event  5) 

2.  DATANET  Acceptance  Time  From  the  H6000  (Event  8  -  Event  3  or  4) 

3.  DATANET  Processing  Time  (Event  9  -  Event  8) 

4.  DATANET  Transmission  Time  (Event  10  -  Event  9) 

5.  User  Processing  Time  +  DATANET  Input  Time  (Event  5  -  Event  10) 

6.  Machine  Response  Time  (Event  3  or  4  -  Event  6  or  2) 

7.  System  Response  Time  (Event  4  -  Event  6) 

Machine  Response  Time  is  calculated  as  the  sum  of  the  individual  H6000 
responses.  As  an  example,  when  a  user  lists  a  large  file  on  a  VIP, 
the  H6000  will  transmit  several  lines  at  a  time  to  the  DATANET-355. 
When  the  screen  is  full,  the  H6000  requests  input  from  the  user  (i.e., 
clear  screen)  so  the  H6000  knows  when  to  continue  transmitting  data. 
The  sum  of  the  transmission  times  of  each  of  the  segments,  up  to  the 
request  for  input,  is  considered  machine  response  time.  A  sample 
trace  sequence  by  event  number  would  be: 

a.  Event  #5  (DATANET-355  asking  H6000  to  list  file) 

b.  Event  #6  (H6000  has  received  request) 

c.  Event  #3  (H6000  sending  four  or  five  lines  back  to  DATANET) 

d.  Event  #8  (DATANET-355  has  received  output) 

e.  Event  #9  (Transmission  to  terminal  begun) 


f . 

Event 

g- 

Event 

h. 

Event 

i. 

Event 

j- 

Event 

k. 

Event 

1. 

Event 

m. 

Event 

data  and  is  requesting  input  from  user;  i.e.,  clear  screen,  break, 
etc . ) 


Machine  Response  m  (c-b)  +  (h-g)  +  (m-1) 

System  response  is  calculated  as  the  total  elapsed  time  from  user 
input  to  request  for  more  user  input-  In  the  above  example,  this 
would  be  (m-b) • 


10.4  Data  Reduction  Methods 

The  DATANET-355  Data  Reduction  Program  outputs  consist  of  histograms, 
serial  plots,  and  tabular  reports.  These  outputs  have  a  number  of 
parameters  which  can  be  modified  by  card  input  at  run  time.  Most 
reports  may  be  turned  on  or  off,  and  a  set  of  timespans  may  be 
specified  for  measurement.  These  options  are  completed  described  in 
subsection  10.6.  The  method  for  altering  histograms  and  plots  require 
an  understanding  of  the  internal  parameters  that  control  these 
outputs.  These  parameters  will  be  described  in  this  subsection. 

The  user  has  the  option  of  obtaining  a  set  of  eight  histograms 
describing  the  response  being  obtained  during  various  phases  of 
processing.  These  histograms  will  be  described  in  subsection  10.5.3. 
These  histograms  are  normally  not  produced  and  must  be  requested  for 
specific  DATANETs  and/or  terminals.  The  method  for  requesting 
histograms  will  be  described  in  subsection  10.6.1  and  10.6.20.  A  set 
of  eight  histograms  will  be  produced  for  each  requested  DATANET  and/or 
terminal.  The  definitions  of  these  response  times  are  given  in 
subsections  5. 2. 7. 7. 3,  5.4.8,  and  10.3  of  this  document. 

There  are  two  characteristics  for  each  histogram  directly  available  to 
the  user.  The  first  of  these  characteristics  is  the  lowest  value, 
stored  in  the  LOW  array.  Any  input  received  by  this  histogram  that  is 


less  than  this  value  will  be  entered  into  the  first  histogram  cell 
along  with  all  entries  that  fall  within  the  range  of  that  cell.  For 
all  eight  histograms,  this  array  defaults  to  zero.  There  is  an  input 
action  which  allows  the  user  to  modify  this  array  for  any  of  the  eight 
histograms  (see  subsection  10.6.20). 

The  second  characteristic  is  the  range  or  width  of  each  cell.  It  is 
determined  by  the  INTEV  array.  Once  again,  there  is  a  user  action 
which  allows  the  user  to  modify  this  array  for  any  of  the  eight 
histograms.  The  default  values  are  (5,2,2,1,10,2,2,1)  respectively. 

The  size  of  the  histogram  is  determined  from  the  internal  parameter 
MXTBSZ  which  specifies  how  many  cells  or  "buckets"  are  contained  in 
the  histogram.  It  indirectly  specifies  the  upper  value  which  could 
fall  within  the  display  range  of  the  histogram.  If  an  entry  is  made 
above  this  range,  it  is  placed  in  an  out-of-range  cell  of  the 
histogram.  The  number  of  the  out-of-range  occurrences  is  printed  with 
the  histogram,  along  with  their  average  .value,  so  that  the  histogram 
can  be  altered  to  handle  the  variability  of  the  range  properly.  If  an 
increase  beyond  this  is  desired,  MXTBSZ  must  be  increased  causing  an 
increase  in  the  memory  size  of  the  data  reduction  program.  This  must 
be  done  via  an  edit  of  the  source  code,  ensuring  that  all  values  of 
MXTBSZ  are  changed.  The  current  value  of  MXTBSZ  is  50. 

There  are  three  characteristics  directly  available  to  the  user  for 
each  individual  plot  used.  The  actual  plot  formats  and  information 
that  is  plotted  will  be  described  in  subsection  10.5.2*  The  first 
characteristic,  MAXNUM,  is  the  maximum  absolute  length  of  the  abcissa 
(print  lines)  to  be  plotted.  The  second  and  third  characteristics, 
YMAX  and  YMIN,  define  the  upper  and  lower  limits  of  the  horizontal 
ordinate.  These  two  values,  along  with  the  width  of  the  print  page, 
determine  the  value  of  one  increment,  along  the  horizontal  axis 
(referred  to  as  DELTA  on  the  plot).  The  actual  formulas  used  are: 

DELTA  -  INTECER  ((YMAX  -  YMIN)/126  +  .5) 

YMAX  -  DELTA*  126  +  YMIN 

Figure  10-1  shows  the  default  values  for  the  plots.  Subsection  10.6.2 
describes  how  plot  parameters  may  be  altered. 

10.5  DDRP  Output 

The  DDRP  outputs  consist  of  histograms,  serial  plots,  and  tabular 
reports.  Table  10-1  lists  all  reports  available  to  the  user  by 
default  or  by  input  request.  The  input  requests  will  be  described  in 
subsection  10.6  and  the  actual  reports  will  be  described  in  this 
subsection.  The  reports  of  the  DATANET  Reduction  Program  can  be  used 
to  study  the  following  for  each  active  DATANET: 


10-4 


Plot  # 


Max  Lines  In  Plot 


Y-Axis  Max 


Y-Axis  Min 


1 

No  limit 

500 

0 

2 

No  limit 

3000 

0 

3 

No  limit 

30000 

500 

4 

No  limit 

50000 

15000 

5 

No  limit 

100 

0 

6 

No  limit 

100 

0 

7 

No  limit 

10000 

0 

8 

No  limit 

150 

0 

9 

No  limit 

100 

0 

,  ,i 

►  f 


r-i 
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Figure  10-1.  Default  Values  For  Plots 
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Table  10-1.  DATANET-355  Reports  (Part  1  of  3) 

Tabular  Reports  Generated  by  Default 

Report  ID/ 

File  Code  Description 

RESPD/21  Average  Response  Time  For  All  Users  by  DATANET 

BUFF/21  HSLA/Subchannel  Transmission  Report  by  DATANET 

RESPL/28  Average  Response  Time  For  Specifically  Designated  Line 

IDs 

HSLA/21  HSLA  Subchannels  Being  Monitored 

CARD/21  Card  Images  from  I*  of  the  GMF  Monitor  (always 

generated) 

-/23  List  of  Active  Line  IDs  (always  generated) 

THRESH/20  HSLA  Threshold  Report  (default  =  9999999) 

-M2  Response  Interval  Unmatched  Pairs  Verification  (always 

generated  when  DATANET  reports  are  produced) 

-M2  Response  Reject  Messages 

Tabular  Reports  Generated  By  Request 
MATCH/20  Response  Interval  Matched  Pairs  Verification 

TRACE/22  Annotated  List  of  the  DATANET  Trace 
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Table  10-1.  (Part  2  of  3) 


Report  ID/ 
File  Code 

HISTG1/21 

HISTG2/21 

HISTG3/21 

RISTG4/21 

HISTG5/21 

HISTG6/21 

HISTG7/21 

RISTG8/21 


Histogram  Reports  Generated  by  Request 
For  a  DATANET  or  Special  Line  ID 

Descript  ion 

H6000  Data  Acceptance  Time  From  Requested  Device 

Data  Acceptance  Time  For  Requested  Device  From  H6000 

Processing  Time  For  Requested  Device 

Transmission  Time  For  Requested  Device 

User  Processing  +  Data  Input  Time  For  Requested  Device 

H6000  Machine  Response  Time  For  Requested  Device 

System  Response/User  Request  For  Requested  Device 

H6000  Responses/User  Request  For  Requested  Device 

Above  set  of  eight  histograms  is  repeated  for  each 
requested  DATANET  or  special  line  ID. 
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Table  10-1.  (Part  3  of  3) 


Plot  Reports  Generated  by  Default 

Report  ID/ 

File  Code  Description 

PL0T1/31  Transactions  Sent  to  Host  (cumulative  every  5  minutes) 

PLOT2/32  Transactions  Received  From  Host  (cumulative  every  5 

minutes ) 

PLOT3/33  36-bit  Words  Sent  to  Host  (cumulative  every  5  minutes) 

PLOT4/34  36-bit  Words  Received  From  Host  (cumulative  every  5 

minutes) 

PLOT5/35  %  Idle  Time  Over  a  5-Minute  Period 

PLOT6/36  7.  Buffer  Requests  Denied  Over  a  5-Minute  Period 

PLOT7/37  18-bits  Average  Number  of  Words  Available  For  Buffers 

Over  a  5-Minute  Period 

PL0T8/38  Average  Number  of  Users  Logged  On  Over  a  5-Minute 

Period 

PLOT9/39  Host  RSVPs  Received  by  DATANET  (cumulative  every  5 

minutes) 
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Amount  of  activity  by  DATANET  -  includes  buffer  denials,  number 
of  transactions  sent  to  and  received  from  the  host,  number  of 
36-bit  words  sent  to  and  received  from  the  host,  host  RSVPs 
received,  the  amount  of  time  spent  idle,  and  a  count  of  the 
number  of  users  logged  onto  the  DATANET; 

Response  time  by  DATANET  and  by  specified  line  ID  -  includes 
analysis  of  a  series  of  response  time  delays; 

HSLA  subchannel  activity  by  DATANET  -  includes  number  of 
transmits  and  receives. 

Immediately  prior  to  the  reports  listing,  a  summary  of  processing 
information  is  printed.  Included  in  this  summary  are  the  following: 

0  list  of  all  input  options  selected  by  the  user; 

°  indication  of  sequential  input  tapes  being  mounted; 

°  error  messages  (self-explanatory); 

°  if  the  timespan  option  was  used,  an  indication  of  when  the 
various  timeframes  were  reached. 

In  the  following  sections  an  example  of  each  report  is  displayed  and  a 
simple  explanation  of  what  data  was  used  in  the  creation  of  the  report 
is  given. 

10.5.1  DATANET-355  Tabular  Reports.  The  following  tabular  reports 
can  be  obtained  in  a  data  reduction  run. 

10.5.1.1  Average  Response  Time  for  All  Dsers  by  DATANET  (Report 
RESPD) .  The  report  shows  the  average  response  times,  for  each 
response  time  category  by  DATANET.  The  number  of  requests  and 
accumulated  response  times  are  also  displayed.  Each  response  time 
catagory  is  defined  in  subsection  10.3.  The  report  also  displays  the 
tapes  from  which  the  data  was  obtained  and  the  date  and  time  to  which 
the  report  corresponds.  The  times  for  which  each  DATANET  was  active 
are  given  at  the  bottom  of  the  report.  This  report  is  printed  as  file 
code  21  at  closure  of  a  timespan  and  end  of  processing.  Ac  each 
printing,  measurements  begin  anew  for  each  DATANET  affected.  Refer  to 
figure  10-2  for  an  example  of  this  report.  In  generating  this  report, 
the  individual  response  times  for  all  terminals  on  a  DATANET  are 
averaged  together  to  determine  the  response  time  of  the  DATANET.  In 
the  current  version,  the  default  value  for  the  number  of  terminals 
that  can  be  processed  is  50.  If  more  then  50  terminals  can  be  active, 
on  a  given  DATANET,  the  parameter  MAXID  must  be  changed  via  an  edit, 
and  the  program  recompiled.  In  addition,  the  size  of  the  program  will 


10-9 


10-10 


1 


Increase  by  15  words  for  each  Integer  increase  of  MAXID.  This  report 
will  be  generated  only  if  the  response  time  portion  of  the  DATANET-355 
GMF  Monitor  was  active  during  data  collection  (see  subsection  5.5.9). 

10.5.1.2  HSLA/ Subchannel  Transmission  Report  by  DATANET  (Report 
BUFF) .  This  report  displays  the  HSLA  subchannel  usage  by  DATANET. 

For  each  subchannel  being  monitored,  the  number  of  transmits  and 
receives  are  printed.  A  totals  line  for  each  DATANET  is  also 
displayed.  The  data  for  this  report  is  obtained  from  the  terminal 
monitoring  entries  (type  3  records)  of  the  host  buffer.  This  report, 
one  for  each  affected  net,  is  output  on  file  code  21  at  closure  of  a 
timespan  and  end  of  processing.  At  each  printing,  measurements  begin 
anew.  This  report  will  be  generated  only  if  the  HSLA  monitoring 
portion  of  the  DATANET-355  GMF  Monitor  was  active  during  data 
collection  (see  subsection  5.5.9).  Refer  to  figure  10-3. 

10.5.1.3  Average  Response  Time  for  Specifically  Designated  Line  IDs 
(Report  RESPL ) .  This  report  presents  the  average  response  times,  for 
each  response  time  category,  for  each  line  ID  designated  for  special 
analysis.  Each  response  time  category  is  defined  in  subsection  10.3. 
The  response  times  are  tallyed  on  a  terminal  session  basis.  A 
"connect  to  slave"  record  (subtype  1  of  the  response  time  record 
entries)  initiates  the  data  collection  for  a  specific  line  ID,  and  a 
"line  disconnect"  record  (subtype  7  of  the  response  time  record 
entries)  terminates  collection.  The  line  disconnect  sends  a 
line-of-print  to  the  report,  showing  the  connect  and  disconnect  TOD  as 
well  as  the  average  response  times  for  that  line  ID.  A  summary 
paragraph  is  listed  whenever  a  net  disconnect,  closure  of  a  timespan 
or  end  of  processing  occurs.  The  summary  shows  the  average  rosoonse 
times  for  each  active  line  on  the  net  affected,  as  well  as  T'Ds 
during  which  the  data  was  collected.  The  period  during  which  the  data 
was  collected  for  the  summary  depends  upon  what  causes  the  previous 
summary  -  a  net  disconnect  resets  average  response  time  counters  only 
for  line  IDs  attached  to  that  net.  Any  other  cause  resets  the  average 
time  counters  for  all  line  IDs.  File  code  28  is  dedicated  to  this 
report .  An  example  is  shown  as  figure  10-4 .  This  report  will  be 
generated  only  if  the  response  time  portion  of  the  DATANET-355  GMF 
Monitor  was  active  during  data  collection  (see  subsection  5.5.9). 

10.5.1.4  HSLA  Subchannels  Being  Monitored  (Report  HSLA).  This 
report,  derived  from  terminal  monitoring  entries  (type  3  records), 
lists  each  HSLA  number  and  subchannel  monitored  for  data  collection 
(see  subsection  5.9.9)  in  the  GRTS-II  monitor  run.  The  report  'is 
written  once  for  each  QATANET  eligible  for  processing,  when  the  net's 
first  T62  trace  is  reduced.  Figure  10-5  shows  an  example  of  this 
report.  It  is  written  to  file  code  21. 
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Figure  10-3.  HSLA/ Subchannel  Transmission  Report  (Report  BUFF) 
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MONITORING  HSLA  1  SUBCHANNEL  12 
MONITORING  HSLA  1  SUBCHANNEL  13 
MONITORING  HSLA  1  SUBCHANNEL  14 
MONITORING  HSLA  1  SUBCHANNEL  15 


10.5.1.5  Card  Images  from  I*  of  the  GRTS-II  Data  Collection  (Report 
CARD) .  These  card  images  were  originally  control  data  from  the  GMC. 
The  first  card  was  interpreted  by  GMC  as  specifying  which  of  the  ten 
monitors  were  to  remain  inactive  during  the  data  collection  run.  If 
monitor  #6,  coded  “M6,"  was  not  listed,  then  the  GRTS-II  monitor 
should  have  been  active  and  T62  traces  expected.  Succeeding  card 
images  informed  GMC  of  the  datanet  monitoring  options  selected  by  the 
user  (see  subsection  5.5).  They  are  repeated  here  to  provide 
environment  data.  Figure  10-6  gives  an  example  of  this  report.  It  is 
printed  once  on  file  code  21. 

10.5.1.6  List  of  Active  Line  IDs.  Displayed  on  this  report  is  the 
identity  of  each  line  ID  active  during  the  reduction  (to  a  maximum  of 
50).  Only  nets  selected  for  analysis  (not  deselected)  contribute. 

The  data  is  taken  from  every  response  time  entry  (type  2)  carrying  a 
line  ID  tag.  The  report  is  listed  on  file  code  23  whenever  closure  of 
a  timespan,  disconnect,  or  end  of  processing  occurs.  Figure  10-7  is 
an  example.  This  report  will  be  generated  only  if  the  response  time 
portion  of  the  DATANET-355  GMF  Monitor  was  active  during  data 
collection  (see  subsection  5.5.9). 

10.5.1.7  HSLA  Threshold  Report  (Report  THRESH).  This  report,  derived 
from  terminal  monitoring  entries  (type  3  records),  indicate  whenever 
the  number  of  transmits  or  receives,  corresponding  to  any  monitored 
HSLA  subchannel  (see  subsection  5.5.9),  exceeds  a  preset  threshold 
value.  The  default  threshold  values  are  set  high  so  that  this  report 
is  not  normally  produced.  If  the  user  wants  to  obtain  this  report  he 
must  activate  user  input  option  THRESH  (see  subsection  10.6.17).  The 
threshold  values  are  compared  to  the  number  of  transmits  or  receives 
monitored  across  an  HSLA  subchannel  between  any  two  consecutive 
DATANET  traces.  The  message  produced  indicates  the  threshold 
surpassed  ( transmi ts-XMITS ,  receives-RCVS) ,  the  time  of  day,  the  HSLA 
subchannel,  and  the  amount  of  time  that  has  passed  since  the  previous 
trace.  Figure  10-8  is  an  example  of  this  report.  This  report  will  be 
written  to  file  code  20. 

10.5.1.8  Response  Interval  Qnmatched  Pairs  Verification.  Unmatched 
pairs  are  said  to  occur  for  a  specific  line  ID  when  successive  data 
response  time  records  for  that  line  cannot  be  affirmed  as  matched 
pairs  (see  subsections  10.6.21,  10.3  and  10.5.1.9). 

Unmatched  pairs  are  noted  within  the  DATANET-355  Reduction  Program, 
and  are  printed  when  discovered.  The  report  appears  on  file  code  42. 

A  summary  count  is  printed  whenever  closure  of  a  timespan  or  end  of 
processing  occurs.  A  typical  line  of  output  is  shown  below. 

Example  of  unmatched  pairs  verification: 

UNMATCHED  ACCEPT  DIRECT  OUTPUT  RECORD  P0R  DNET  1  LNID  DG  SUBSYSTEM  TSS 
TYPE  VIP  785  AT  08:09:33 
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Figure  10-7.  List  of  Active  Line  IDs 


This  message  indicates  that  the  data  is  not  being  received  in  the 
order  expected  and  should  be  considered  as  an  error  condition.  CCTC 
(C751)  should  be  contacted  when  this  condition  is  found  to  exist.  A 
similar  problem  exists  if  the  word  "UNMATCHED"  is  replaced  by  the  word 
“DUPLICATE."  Both  these  cases  indicate  data  not  being  received  in  the 
order  expected.  Table  10-2  displays  all  such  occurrences  of  these 
messages  and  reasons  for  the  problem.  This  report  will  be  generated 
only  if  the  response  time  portion  of  the  DATANET-355  GMF  Monitor  was 
active  during  data  collection  (see  subsection  5.5.9). 

10.5.1.9  Response  Interval  Matched  Pairs  Verification  (Report 
MATCH) .  Data  transmission  between  host  and  front  end  is  governed  by 
the  series  of  events  described  in  section  10.3.  A  matched  pair  is 
affirmed  on  detecting  any  sequence  that  generates  a  valid  response 
time  measurement  as  described  in  section  10.3,  for  the  same  line  ID 
within  a  single  T62  trace.  This  report  will  be  generated  only  if  the 
response  time  portion  of  the  DATANET-355  GMF  Monitor  was  active  during 
data  collection  (see  subsection  5.5.9). 

Matched  pairs  are  noted  within  the  DATAN'ET-355  Data  Reduction  Program, 
and  are  printed  when  affirmed,  and  when  both  the  following  two 
conditions  are  true:  (1)  the  option  has  been  specifically  selected 
(see  subsection  10.6.15)  and  (2)  the  response  time  threshold 
(separately  specified  for  each  response  time  category)  has  been 
exceeded.  The  report  appears  on  file  code  20.  A  typical  line  of 
output  is  shown  below. 

Example  of  matched  pairs  verification: 

DN— 355  DATA  ACCEPTANCE  TIME  FOR  75  SECS  ON  DNET  1  FOR  LNID  DG  TYPE  - 
VIP  7855  FOR  SUBSYSTEM  VIDEO  AT  08:08:12 

This  report  may  be  used  to  capture  the  occurrence  of  response  or 
processing  times  that  are  considered  to  be  excessive. 

10.5.1.10  Annotated  List  of  Datanet  Traces  (Report  TRACE).  This 
report  can  only  be  produced  by  use  of  the  special  input  option  TRACE 
(see  subsection  10.6.12).  It  will  produce  voluminous  output  and 
should  only  be  used  for  debug  purposes.  The  report  will  produce  a 
formatted  dump  of  the  various  DATANET  355  GMF  data  records  and  is  only 
meaningful  to  someone  familiar  with  the  correct  record  formats.  No 
sample  of  this  report  is  given  in  this  document. 

10.5.2  Plots.  The  plots  described  in  the  following  subsections  can 
be  obtained  from  a  data  reduction  run.  Table  10-1  lists  the  data 
collections  that  can  be  plotted.-  Each  plot  contains  the  information 
for  all  known  DATANET s.  Plot  listings  are  found  on  file  code  25. 

Since  the  plots  can  produce  a  tremendous  amount  of  output,  it  is 
suggested  that  the  plot  time  interval  not  be  made  too  small.  The 


Table  10-2.  Response  Time  Error  Messages 


ERROR  MESSAGE 


duplicate  Send  Output 


Duplicate  Accept  Direct 
Output  or 

Duplicate  Accept  Direct 
Output/Input 

Unmatched  Accept  Direct 
Output  or 

Unmatched  Accept  Direct 
Output/Input 

Unmatched  Accept  Direct 
Input 

Unmatched  Input  Accepted 


Duplicate  Input  Accepted 


Duplicate  Total  System 
Response  Time 

Unmatched  Output  Received 

Duplicate  Output  Received 

Unmatched  Output  Started 

Duplicate  Output  Started 

Duplicate  Output  Completed 

HO 000  Rejected  Accept 
Direct  Input  (THIS  IS 
IS  NOT  AN  ERROR  CONDITION) 


REASON 


A  duplicate  event  2  has  been  received 
before  the  occurrence  of  an  event  3  or 

4. 


A  duplicate  event  3  or  4  has  been 
received  before  the  occurrence  of  an 
event  8. 


An  event  3  or  4  has  occurred  before  an 
event  2  or  6. 


An  event  5  has  occurred  before  an  event 

10. 


An  event  6  has  occurred  before  an  event 
5. 

A  duplicate  event  6  has  been  received 
before  the  occurrence  of  an  event  3  or 
4. 

A  duplicate  event  6  has  occurred  before 
an  event  4. 

An  event  8  has  occurred  before  an  event 
3  or  4. 

A  duplicate  event  8  has  occurred  before 
an  event  9. 

An  event  9  has  occurred  before  an  event 

8. 

A  duplicate  event  9  has  occurred  before 
an  event  10. 

A  duplicate  event  10  has  occurred  before 
the  occurrence  of  an  event  5. 

H6000  too  busy  to  respond  to  DN 
355,  see  subsection  10.6.22. 
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default  plot  interval  is  five  minutes  and  can  be  changed  with  a  user 
input  option  (see  subsection  10.6.14). 


One  horizontal  line  is  output  at  the  specified,  or  default,  plot  time 
interval.  Every  tenth  line  displays  the  current  time  of  day.  If  a 
curve  ordinate  is  on  or  beyond  the  axis  limit,  it  will  be  positioned 
at  the  axis  limit.  If  two  or  more  curves  share  the  same  ordinate 
simultaneously,  the  position  of  coincidence  will  be  marked  with  the 
cardinal  number  of  the  curves  sharing  it.  The  cell  "height"  (value  of 
one  increment  along  the  horizontal  axis)  is  specified  by  a  DELTA  value 
given  in  the  heading.  The  vertical  axis  is  the  time  axis  with  nominal 
increments  of  one  plot  time  interval,  but  rarely  will  the  increments 
be  equal.  The  parameters  which  determine  the  plot  delta  intervals 
(horizontal  increments)  are  described  in  subsection  10.4  and  methods 
for  altering  the  parameters  are  described  in  subsection  10.6.2.  Each 
plot  contains  a  heading  line  giving  the  date  and  the  starting  time  of 
the  collection,  a  title  describing  the  collection,  the  identifying 
mark  of  each  curve,  and  the  DELTA  value.  When  the  plot  time  interval 
is  exceeded  for  any  given  DATANET,  all  DATANETs  will  be  plotted. 
Therefore,  it  is  probable  that  in  a  multiple  DATANET  environment  a 
given  plot  entry  will  reflect  different  amounts  of  time  for  each  of 
the  DATANETs.  In  order  to  make  the  plots  more  readable,  it  is 
suggested  that  only  a  single  DATANET  be  plotted  at  one  time.  This 
will  require  multiple  reductions  to  be  run,  turning  off  the  plot 
option  for  different  DATANETs,  but  output  will  be  easier  to  read.  The 
method  for  doing  this  is  described  in  subsection  10.6.13. 

10.5.2.1  Number  of  Transactions  Sent  to  Host  (Plot  ID  PLOTl).  This 
report  plots  the  cumulative  number  of  transactions  sent  to  the  host, 
over  a  plot  Interval  of  time,  by  DATANET,  as  obtained  from  the  host 
buffer  for  CPU  utilization  (record  type  1,  subtype  4).  Figure  10-9 
shows  an  example.  In  this  plot  we  see  that  DATANET  0  has  accumulated 
3560  transactions  between  0800,  when  the  monitor  started,  and  0822, 
when  the  first  plot  entry  was  made.  In  this  plot,  each  dash  (delta 
value)  is  equivalent  to  40  transactions,  and  therefore,  the  "A"  is 
plotted  at  the  89th  dash  mark.  During  that  same  Interval  of  time, 
DATANET  1  had  accumulated  4400  transactions.  From  0822  until  the  next 
plot  interval  of  time  (approximately  15  minutes,  depending  on  vnen  the 
data  buffer  was  received),  DATANET  0  again  accumulated  3560 
transactions,  but  DATANET  1  accumulated  only  2520  transactions. 
Therefore,  the  B  is  written  out  at  the  63rd  mark.  The  plots  need  to 
be  read  as  a  continuous  line  of  output.  Therefore,  the  user  will  need 
to  connect  the  same  lettered  points  in  order  to  track  the  change  that 
has  occurred.  During  the  next  time  interval,  DATANET  0  decreased  to 
2520  transactions,  while  DATANET  1  increased  to  3560  transactions. 

10.5.2.2  Number  of  Transactions  Received  From  Host  (Plot  ID  PL0T2). 
This  report  plots  the  cumulative  number  of  transactions  received  from 
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the  host,  over  a  plot  interval  of  tine,  by  DATANET,  as  obtained  from 
the  host  buffer  for  CPU  utilization  (record  type  1,  subtype  5).  This 
plot  should  be  interpreted  in  the  same  manner  as  figure  10-9  and 
therefore  no  example  is  included. 

10.5.2.3  Number  of  36-Bit  Words  Sent  to  Host  (Plot  ID  PL0T3).  This 
report  plots  the  cumulative  number  of  36-bit  words  sent  to  the  host, 
during  a  plot  interval  of  time,  by  DATANET,  as  obtained  from  the  host 
buffer  for  CPU  utilization  (record  type  1,  subtype  6).  This  plot 
should  be  interpreted  in  the  same  manner  as  figure  10-9  and  therefore 
no  example  is  included. 

10.5.2.4  Number  of  36-Bit  Words  Received  From  Host  (Plot  ID  PL0T4). 
This  report  plots  the  cumulative  number  of  36-bit  words  received  from 
the  host,  during  a  plot  interval  of  time,  by  DATANET,  as  obtained  from 
the  host  buffer  for  CPU  utilization  (record  type  1,  subtype  7). 

Figure  10-10  provides  a  sample  of  this  type  plot  and  should  be 
interpreted  in  the  same  manner  as  figure  10-9.  Mote  the  occurrence  of 
the  2's  as  both  Datanet  A  and  B  have  reported  identical  values  during 
the  second  and  third  time  increments. 

10.5.2.5  Percent  Idle  Time  Over  a  Plot  Interval  (Plot  ID  PLOTS). 

This  report  plots  the  percent  of  time,  over  a  plot  interval,  that  each 
DATANET  was  idle.  Tf  a  DATANET  crashes  during  this  interval,  the 
amount  of  time  spent  down,  due  to  the  crash,  is  disregarded  (i.e.,  the 
length  of  the  interval  for  the  DATANET  that  crashed  will  be  reduced  by 
the  amount  of  time  the  DATANET  was  down).  This  information  is 
obtained  from  the  host  buffer  for  CPU  Utilization  (record  type  1, 
subtype  9).  Figure  10-11  provides  an  example  of  this  plot.  In 
examining  this  plot,  it  can  be  seen  that  during  the  first  time 
interval,  DATANET  0  was  32  percent  idle,  while  DATANET  1  was  30 
percent  idle.  During  the  second  time  interval,  DATANET  0  became  27 
percent  idle,  while  DATANET  1  remained  30  percent  idle.  During  the 
third  time  interval,  DATANET  0  had  a  29  percent  idle  time,  while 
DATANET  1  had  a  27  percent  idle  time. 

10.5.2.6  Percent  Buffer  Requests  Denied  (Plot  ID  PL0T6).  This  report 
plots  the  percent  of  buffer  requests  that  were  denied  during  a  single 
plot  interval  of  time,  by  DATANET,  as  obtained  from  the  host 

buffer  for  CPU  utilization  (record  type  1,  subtype  1  and  10).  As  can 
be  seen  in  the  figure,  two  DATANETs  are  being  monitored  for  three  time 
intervals.  Both  DATANETs  are  reporting  60  percent  of  their  buffer 
requests  being  denied.  Since  two  DATANETs  are  reporting  the  same 
value,  the  number  “2"  appears  on  the  plot,  indicating  the  intersection 
of  two  values.  Refer  to  figure  10-12  for  a  sample  of  this  type  plot. 

10.5.2.7  Number  of  18-Bit  Words  Available  For  Buffers  (Plot  ID 
PL0T7 ) .  This  report  plots  the  average  number  of  18-bit 'words 

vallable  for  buffers,  over  a  plot  Interval  of  time,  by  DATANET,  as 
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Figure  10-10.  Number  of  36  Bit  Words  Received  From  Host  (Plot  4) 
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Figure  10-12.  Percent  Buffer  Requests  Denied  (Plot  6) 


obtained  from  the  host  buffer  for  CPU  utilization  (record  type  1, 
subtype  2).  This  plot  is  interpreted  in  the  same  manner  as  other 
plots  and  therefore,  an  example  is  not  provided. 

10.5.2.8  Number  of  Users  Logged  On  The  System  (Plot  ID  PL0T8).  This 
report  plots  the  average  number  of  users  logged  on  each  DATANET, 
during  a  plot  interval  of  time,  as  obtained  from  the  host  buffer  for 
CPU  utilization  (record  type  1,  subtype  3).  This  plot  is  interpreted 
in  the  same  manner  as  other  plots  and  therefore,  an  example  is  not 
provided . 


10.5.2.9  Number  of  Host  RSVPs  Received  (Plot  ID  PL0T9 ) .  This  report 
plots  the  cumulative  number  of  host  RSVPs  received,  during  a  plot 
interval  of  time,  by  DATANET,  as  obtained  from  the  host  buffer  for  CPU 
utilization  (record  type  1,  subtype  8).  This  plot  is  interpreted  in 
the  same  manner  as  other  plots  and  therefore,  an  example  is  not 
provided . 

10.5.3  Histograms.  Histogram  reports  are  produced  for  each  response 
time  category  described  in  section  10.3.  Histograms  can  be  produced 
for  all  known  DATANETs  (up  to  four)  and  special  line  IDs  (up  to  10). 
Included  on  each  listing  are  the  time  and  date  the  data  were 
collected,  the  system  name  on  which  they  were  collected,  response 
category,  and  the  report  ID.  The  histogram  proper  includes  cells 
count  and  frequency,  both  individual  and  cumulative,  as  well  as  the 
range  and  scale  of  each  cell.  A  bar  chart  comparing  the  cell 
frequencies,  and  a  statistical  summary  of  in-range  and  out-of-range 
events  completes  the  chart.  Figures  10-13  and  10-14  show  sample 
histograms  as  produced  by  a  DATANET  and  a  special  line  ID.  Histograms 
will  be  outputted  at  the  end  of  a  timeframe  or  at  the  end  of 
processing.  A  closing  line  on  each  histogram  shows  the  TODs  between 
which  the  histogram  data  are  valid,  and  why  the  histogram  was 
printed.  Successive  histograms  for  the  same  application  are  never 
cumulative. 

Figure  10-13  will  be  used  to  describe  the  procedure  that  should  be 
followed  in  Interpreting  a  histogram.  Entries  in  the  column  headed 
SECOND  give  the  range  of  times  which  form  each  histogram  bucket.  The 
first  bucket  is  used  to  report  0  measured  values,  if  any,  with  all 
other  buckets  used  to  represent  a  range  of  values.  The  user  should 
refer  to  subsection  10.4  for  a  discussion  of  range  values  within 
histograms  and  subsection  10.6.20  for  the  method  of  altering  the 
standard  ranges.  The  entries  in  the  column  headed  INDIV.  NUMBER  give 
the  number  of  reponses  that  were  measured  that  fell  within  the  time 
range  specified  by  the  SECOND  column.  In  figure  10-13,  we  observe 
that  144  responses  measured  between  2  and  3  seconds. 
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Figure  10-13.  Histogram  of  DATANET  Response 
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Similarly,  the  columns  headed  INDIV.  PRC  and  CUMUL.  PRC  give  the 
individual  and  cumulative  percentages  of  all  responses  which  were  made 
within  each  time  range.  In  figure  10-13,  we  observe  that  48%  of  all 
responses  were  1  second  in  duration,  while  51%  were  between  2  and  3 
seconds  in  duration.  At  the  same  time,  it  can  be  observed  (CUMUL. 

PRC)  that  100%  of  all  responses  were  measured  at  3  seconds  or  less. 

10. 6  Default  Option  Alteration 

The  DDRP  uses  the  trace  tape  generated  by  the  QIC  and  user  data  cards 
as  input.  The  user  has  several  optional  inputs.  These  options  are 
evoked  by  specifying  an  input  option  (action  code)  and  any  other 
required  inputs  specified  in  the  following  subsections.  The  general 
format  for  an  option  request  is  as  follows: 

The  first  card  is  an  action  code  describing  the  action  to  be  taken. 
Subsequent  cards  modify  report  parameters  for  some  of  the  action 
codes.  All  inputs  are  free  format  with  the  only  requirement  being 
that  all  zeros  must  be  typed  on  the  data  card.  At  least  one  data  card 
with  the  word  END  specified  is  required  as  the  last  data  card. 

Available  action  codes  (and  default  implications)  (and  character  code) 
are : 

1.  Turn  histogram  on;  (no  histograms)  (HISTG) 

2.  Modify  a  plot;  (standard  plots)  (PLOT) 

3.  Turn  a  specific  report  on;  (all  reports  on  except  ID  TRACE, 
MATCH,  and  histograms)  (ON) 

4.  Turn  a  specific  report  off;  (all  reports  on  except  ID  TRACE 
MATCH,  and  histograms)  (OFF) 

5.  Set  a  timespan  for  measurement;  (time  not  a  criterion  for 
measurement)  (TIME) 

6.  Process  Data  Reduction  Program  on  a  WW6.4/2H  system  (WW7.2/4JS 
processing)  (RN) 

7.  Turn  all  reports  off  except  those  specified;  (all  reports  on 
except  ID  TRACE,  MATCH,  and  histograms)  (ALLON) 

8.  Turn  all  reports  on  except  those  specified;  (all  reports  on 
except  ID  TRACE,  MATCH,  and  histograms)  (ALLOFF) 

9.  Do  not  stop  on  an  option  request  error;  (stop  on  an  input 
error)  (ERROR) 
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10.  Number  of  physical  tape  records  to  process  before  stopping; 
(number  of  records  not  a  constraint)  (  NREC) 

11.  All  reports  off  except  plots;  (all  reports  on  except  ID  TRACE, 
MATCH,  and  histograms)  (REPORT) 

12.  Dump  formatted  record  types  listed;  (no  dump)  (TRACE) 

13.  DATANETs  not  to  analyze  for  plots;  (all  are  plotted)  (N0PL0T) 

14.  Set  minimum  plot  interval;  (five  minute  plot  interval)  (INTERV) 

15.  Verify  response  time  records  (type  2)  matched  (at  end  of 
processing  of  each  T62  trace)  (no  verification)  (MATCH) 

16.  Accept  line  IDs  for  special  analysis;  (none  get  special 
analysis)  (SPECL) 

17.  Modify  threshold  values  (all  values  9999999)  (THRESH) 

If.  DATANETs  not  to  analyze  for  reports  other  than  plots;  (all  nets 
are  analyzed)  (NORPT) 

19.  Debug  (no  debug)  (DEBUG) 

20.  Modify  parameters  for  histograms  (default  values  described  in 
section  10.4)  (CHANGE) 

21.  Error  Report  (all  unmatched  responses  produced)  (DUPLIC) 

22.  Reject  Report  (reject  messages  are  produced  but  summary  is 
not).  (REJECT) 

There  is  no  order  required  for  the  options,  and  multiple  entries  in 
each  are  permissible.  If  several  Inputs  refer  to  the  same  report,  the 
last  one  encountered  will  have  precedence.  Also,  if  a  report  is  off 
by  default  and  Is  modified,  it  will  be  turned  on  through  its  request 
for  modification.  All  input  cards  are  free  format  unless  otherwise 
described.  If  multiple  parameters  occur  on  a  given  card  they  must  be 
separated  by  at  least  1  blank  column. 

Three  tabular  reports  depart  from  the  normal  scheme  (see  table  10-1): 
the  reports  titled  "List  of  Active  Line  IDs”  and  "Response  Interval 
Unmatched  Pairs  Verification”  are  generated  if  a  T62  trace  is 
processed  and  cannot  be  turned  off.  The  report  titled  "Response 
Reject  Messages"  is  also  produced  by  default  and  can  only  be  altered 
with  the  REJECT  user  option. 


10-32 


10.6.1  Histogram  Desired  (Action  Code  HISTG).  If  the  user  desires 
histograms,  he  must  use  this  action  code.  There  is  no  other  method 
for  obtaining  histograms.  The  user  may  obtain  histograms  for  either 
DAT AMT Ts  or  special  terminals.  This  option  would  be  used  for 
obtaining  DATAMET  histograms.  Terminal  histograms  can  be  requested 
under  action  code  "SPECL".  For  every  requested  DATANET  and/or 
terminal,  a  set  of  eight  histograms  will  be  produced.  Currently,  the 
data  reduction  program  can  produce  a  maximum  of  40  histograms  (five 
sets  of  eight  histograms  each).  If  more  than  this  are  desired,  the 
user  will  need  to  edit  and  recompile  the  source  code.  In  performing 
the  edit,  the  user  should  change  the  value  of  "RPTCNT"  from  the 
current  setting  of  57  to  the  required  new  value.  To  calculate  the  new 
value  of  "RPTCNT,"  the  following  formula  should  be  used: 

RPTCNT  *  17  +  8*  (number  of  sets  of  histograms  desired) 

It  should  be  noted  that  for  every  integer  increase  in  the  value  of 
RPTCNT,  the  amount  of  memory  required  to  run  this  program  increases  by 
80  words.  The  first  card  contains  the  word  HISTG  and  the  second  card 
contains  the  DATANET  number  (0-3)  for  which  the  histograms  are  desired. 

10.6.2  Plot  Alteration  (Action  Code  PLOT).  For  any  given  plot  the 
user  can  alter  the  maximum  number  of  lines  to  be  printed  on  the  plot, 
the  minimum  value  of  the  plot  and  the  maximum  value  of  the  plot  (see 
subsection  10.4).  By  specifying  the  minimum  and  maximum  values  of  the 
plot,  the  user  has  in  effect  specified  the  interval  size  of  the  plot. 

If  a  value  to  be  plotted  is  smaller  then  the  minimum  value  specified, 
the  element  will  be  plotted  so  as  to  Intersect  the  left  axis  of  the 
plot.  If  a  value  to  be  plotted  is  larger  then  the  maximum  value 
specified,  the  element  will  be  plotted  as  an  asterisk  on  the  right 
hand  axis  of  the  plot.  If  the  user  wants  to  insure  that  the  entire 
plot  is  printed,  he  should  input  a  value  of  -1  for  the  number  of  lines 
to  be  printed.  The  minimum  and  maximum  values  must  be  specified  as 
real  numbers,  i.e.  decimal  points  must  be  punched  on  the  data  card. 
Table  10-1  lists  those  measurements  currently  being  plotted  and  figure 
10-1  lists  the  default  values  for  all  plots.  Figure  10-15  shows  the 
format  required  for  this  action  code. 

10.6.3  Turn  a  Report  On  (Action  Code  ON).  This  action  allows  a  user 

to  turn  a  single  report  on  (that  is  off  by  default)  for  this  run.  The 
user  specifies  the  report  ID  (see  table  10-1).  No  change  to  the 
default  parameters  will  be  made,  and  a  report  already  on  will  remain 

on.  All  reports  are  on  by  default  except  the  histograms,  and  report 

ID's  TRACE  and  MATCH.  None  of  these  can  be  turned  on  by  using  this 
option.  To  turn  histograms  on,  the  user  must  use  the  "HISTG”  or 

"SPECL"  options,  and  to  turn  on  the  other  two  reports,  the  user  must 

use  the  "TRACE"  and  "MATCH"  options  respectively.  This  option  is  only 
included  for  completeness  and  will  never  need  to  be  used.  The  format 
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Card  #1 
Card  s*2 


A 

B 


C 


0 


E 


Where 

A  *  The  letters  PLOT 

B  »  Plot  ID  to  be  altered  (see  TABLE  10-1) 

C  »  Number  of  lines  to  be  printed  or  a  -1  if  entire  plot  is  desired 
D  =  Maximum  value  for  plot  inputted  as  a  real  number,  i.e.  with 
decimal  point 

E  =  Minimum  value  for  plot  inputted  as  a  real  number,  i.e.  with 
decimal  point 


Figure  10-15.  Plot  Alteration  (Action  Code-PLOT) 
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consists  of  two  cards.  The  first  contains  the  word  ON  and  the  second 
card  contains  the  report  ID  from  table  10-1  to  be  turned  on. 


10.6.4  Turn  a  Report  Off  (Action  Code  OFF).  This  action  permits  a 
user  to  turn  a  single  report  off  (that  is  on  by  default)  for  this 
run.  The  user  specifies  the  report  ID  (see  table  10-1).  No  change  of 
default  parameters  is  made,  and  a  report  may  be  turned  off  multiple 
times.  All  reports  and  plots  that  are  currently  on  by  default  can  be 
turned  off  with  this  option  except  for  the  report  titled  "Response 
Reject  Messages."  This  report  car.  be  altered  only  with  the  use  of  the 
input  option  REJECT.  The  format  for  this  option  is  the  same  as  the  ON 
option  except  the  word  OFF  replaces  the  word  ON. 

10.6.5  Set  a  Tlmespan  of  Measurement  (Action  Code  TIME).  The  system 

allows  a  user  to  specify  the  tlmespan  (or  spans)  in  which  the 
collected  data  is  to  be  processed  and  reports  generated.  For  example, 
the  user  may  collect  data  from  0500  to  2200  hours  and  specify  that  he 

wants  to  process  only  0900  to  1700  hours  on  all  reports.  The 

timespans  set  through  this  option  apply  to  all  report  processing. 

Up  to  five  timespans  may  be  specified  and  they  must  be  chronologically 
ordered.  In  specifying  timespans  a  start  time  and  a  stop  time  must  be 
supplied.  If  a  start  time  is  specified,  but  no  stop  time  is 
specified,  there  should  be  no  data  on  the  card  after  the  start  time  is 
specified.  All  times  are  expressed  as  S1M1  where  SI  is  the  start  hour 

and  Ml  Is  the  start  minute.  All  times  must  be  expressed  as  4 

character  fields  with  no  intervening  blanks.  If  the  user  wants  to 
request  the  time  4:07  he  must  input  a  "0407”.  Times  are  considered  to 
be  on  a  24  hours  clock. 

Individual  timespans  may  be  set  for  the  entire  data  reduction  run 
(report  ID-TOTAL),  or  for  report  ID's  THRESH  and  TRACE,  or  for  any 
plot.  Report  ID's  for  plots  are  indicated  in  TABLE  10-1.  No  other 
individual  timespans  may  be  set.  The  format  for  this  card  Is  shown  in 
figure  10-16. 

10.6.6  Process  Reduction  on  a  WW6.4/2H  System  (Action  Code  RN).  The 
data  reduction  program  is  designed  to  be  processed  on  a  WW7.2/4JS  GC0S 
release.  However,  the  program  can  be  executed  under  a  WW6. 4/2H  GC0S 
system  with  the  use  of  this  option.  The  option  consists  of  an  RN 
typed  on  the  data  card. 

10.6.7  Turn  All  Reports  Off  Except  Those  Specified  (Action  Code 
ALLOFF) .  All  reports  except  those  explicitly  identified  here  are  to 
be  turned  off.  The  card  format  .is  shown  in  figure  10-17. 

10.6.8  Turn  all  Reports  On  Except  Those  Specified  (Action  Code 
ALLON) .  All  reports  except  those  explicitly  identified  here  are  to  be 
turned  on.  The  card  format  is  shown  in  figure  10-18.  This  action 
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Card  1  A 

Card  2  N  M 

Card  3  B  C  D  E  F  . 

Where 

A  -  The  letters  TIME 

N  *  Report  ID  to  be  tlmespanned.  (see  subsection  10.6.5) 
M  -  Number  of  different  times  appearing  on  card  3 
B,  C,  D,  E,  F  “  Start  and  stop  times  used  to  define  the 
timespan.  (see  subsection  10.6.5) 


Figure  10-16.  Set  Timespan(s)  For  Processing 
(Action  Code  TIME) 


Card  1  A 

Card  2  N 

Card  3  I  J  K  .  .  . 

Where 

A  »  The  letters  ALLOFF 

N  ■  The  number  of  reports  to  be  specified  on  card  3 
I,  J,  K  =  Report  ID's  (from  TABLE  10-1) 

not  to  be  turned  off.  M  of  these  numbers 
must  appear  on  this  card. 


Figure  10-17.  Action  Codes  For  Turning  Reports  Off 


Card  1  A 

Card  2  N 

Card  3  I  J  K  .  .  .  . 

Where 

A  -  The  letters  ALLON 

N  »  The  number  of  reports  to  be  specified  on  card  3 
I,  J,  K  -  Report  ID's  (from  TABLE  10-1)  not  to  be  turned 

on.  N  of  these  numbers  must  appear  on  this  card. 


Figure  10-18.  Action  Codes  For  Turning  Reports  ON 
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cannot  be  used  to  turn  on  histograms*  Action  codes  “HISTG"  and 
"SPECL"  must  be  used  for  histograms*  It  also  should  not  be  used  to 
turn  on  report  ID's  MATCH  and  TRACE.  These  two  reports  are  turned  via 
special  input  options*  For  these  reasons  the  user  should  never  use 
this  option  and  it  is  provided  only  for  a  matter  of  completeness. 

10.6*9  Continue  Data  Reduction  After  an  Input  Option  Error  (Action 
Code  ERROR).  This  code  allows  data  reduction  to  continue  when  an 
error  has  been  detected  in  an  input  option  request.  The  default  value 
will  abort  data  reduction  and  report  the  error.  No  cards  are  required 
after  the  action  card  which  contains  the  word  ERROR. 

10.6.10  Stop  Processing  (Action  Code  NREC) .  This  option  permits  a 
user  to  specify  the  number  of  tape  records  to  process  before 
stopping.  This  is  useful  if  a  hard  tape  error  aborts  the  run  and 
causes  reports  to  be  lost.  In  order  to  obtain  these  reports,  it  is 
necessary  to  stop  processing  prior  to  the  tape  error.  The  first  card 
contains  the  word  NREC  and  the  second  card  contains  the  number  of  tape 
records  to  be  processed. 

10.6.11  Plots  Only  (Action  Code  REPORT).  This  action  code  permits 
the  plots  to  be  generated  and  curtails  all  other  reports.  No  cards 
are  required  after  the  action  card  which  contains  the  word  REPORT. 

10.6.12  Print  formatted  DATANET-355  Record  Types  (Action  Code 
TRACE) .  The  GRTS-II  monitor  of  the  QIC  distinguishes  three  record 
types,  designated  1,  2,  and  3.  Generally,  type  1  records  provide 
gross  net  performance  data;  type  2  records  capture  events  pertinent  to 
each  line  ID;  type  3  records  show  gross  performance  of  each  HSLA 
subchannel.  This  Action  code  permits  the  user  to  specify  which  type 
record  to  format  and  print.  An  additional  option  allows  selection  of 
a  header  showing  various  counters  and  clocks. 

The  first  card  contains  the  word  TRACE.  The  second  card  would 
indicate  which  of  the  possible  options  the  user  is  going  to  describe. 
This  card  can  contain  the  word  TERM,  or  LIMIT,  or  RECTYP,  or  END. 

If  the  word  TERM  appears  on  the  second  card,  then  the  third  card  would 
contain  the  number  of  terminals  (maximum  of  four)  f<  which  the  type 
two  records  are  to  be  formatted.  The  fourth  card  wo  Id  contain  the 
list  of  terminal  IDs  for  which  type  two  record  formatting  is  desired. 
The  IDs  should  be  separated  by  at  least  one  blank. 

The  next  card  would  once  again  contain  the  word  LIMIT,  or  RECTYP,  or 
END. 

If  the  word  LIMIT  appears  on  the  card  then  the  following  card  would 
contain  the  number  of  GRTS  records  that  should  be  formatted  before  the 
formatting  option  will  be  deactivated.  The  card  following  would  once 
again  contain  the  word  RECTYP,  or  END. 
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If  the  word  RECTYP  appears  on  the  card  then  the  following  card  would 
contain  the  number  of  record  types  desired  and  the  DATANET  for  which 
they  are  desired.  A  zero  for  a  DATANET  #  must  be  typed.  A  DATANET 
number  of  -1  indicates  that  all  DATANETs  should  be  processed  in  the 
requested  manner.  The  following  card  would  list  the  actual  record 
types  desired.  The  card  following  should  contain  the  word  END. 

If  the  word  END  appears  on  the  card  processing  of  the  dump  option  will 
terminate.  Any  combination  of  the  above  options  may  follow  a  TRACE 
action  card,  but  the  END  card  must  be  the  last  card  of  the  group.  The 
TRACE  report  is  off  by  default  and  will  be  activated  by  the  processing 
of  this  option. 

10.6.13  DATANETs  Not  to  Plot  (Action  Code  NOPLOT).  This  option 
permits  the  user  to  "turn  off"  plot  data  for  specified  DATANETs.  The 
effect  on  an  active  plot  is  to  zero  the  Y-coordinate  for  the  unwanted 
DATANET.  The  DATANET  identifiers  are  00  through  03.  This  option 
should  be  used  when  reducing  a  tape  containing  data  from  multiple 
DATANETs.  Under  the  default  conditions,  data  from  every  DATANET  will 
appear  on  the  same  plot,  as  different  curves.  While  this  allows  the 
user  to  easily  compare  the  activity  on  multiple  DATANETs  it  does 
present  several  problems.  One  problem  is  that  the  plot  tends  to  be 
difficult  to  read  because  of  the  large  amount  of  data  contained  in  a 
small  area.  The  other  problem  is  one  of  plot  limits.  If  the  activity 
on  the  various  DATANETs  is  significantly  different,  it  becomes 
difficult  to  set  meaningful  minimum  and  maximum  plot  boundaries. 

By  turning  off  plots  for  specified  DATANETs,  the  user  can  see  each 
DATANET  plotted  separately,  or  else  only  see  certain  DATANETs  plotted 
together.  If  the  user  selects  this  option,  multiple  reductions  will 
need  to  be  run  in  order  to  see  the  plots  for  all  DATANETs.  Figure 
10-19  shows  the  format  for  this  action. 

10.6.14  Set  a  Plot  Interval  (Action  Code  INTERV) .  This  option  allows 
the  user  to  set  the  minimum  plot  interval.  The  interval  criterion  is 
applied  to  each  DATANET  individually  and  if  the  test  approves  the 
plot,  the  latest  data  from  all  DATANETs  are  plotted.  The  default 
interval  is  5  minutes  (300  seconds).  The  first  card  contains  the  word 
INTERV  and  the  second  card  contains  the  new  plot  interval  in  seconds. 

10.6.15  Response  Time  Records  (Type  2)  Matched  (Action  Code  MATCH). 
This  option  causes  a  message  to  be  printed  whenever  a  response 
interval  is  completed  (matched).  This  option  can  produce  voluminous 
output  and  should  be  used  with  caution  if  the  data  tape  contains  more 
than  a  few  records.  The  "matched"  option  can  be  used  to  track  the 
origin  of  unusual  response  times  reported  in  DATANET  and 
special-analysis  line  ID  histograms.  A  series  of  seven  threshold 
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Ca  rd  1  A 

Card  2  N 

Card  3  M  L  0.... 

Where 

A  *  The  letters  N0PL0T 

N  =  Number  of  DATANETs  appearing  on  the  third  card,  whose  plots 
will  be  turned  off 

M,  L,  0  »  DATANET  numbers  whose  plots  are  to  be  turned  off.  N 
such  numbers  must  appear  on  card. 

If  the  DATANET  number  is  0,  the  0  must  be  punched 
on  the  card. 


Figure  10-19.  Turn  Off  Plots 
(Action  Code  N0PL0T) 
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values  can  be  specified  to  force  the  tracking  of  tines  greater  than, 
or  equal  to,  the  threshold  value.  The  definition  of  the  various 
response  tines  are  given  in  sections  5. 2. 7. 7. 3,  5.4.8,  and  10.3  of 
this  document.  The  first  card  contains  the  word  MATCH.  The  second 
card  would  contain  the  seven  new  threshold  values  that  are  desired. 
Seven  numbers  must  appear  on  this  card.  The  threshold  must  be 
expressed  in  milliseconds.  This  report  is  not  produced  under  default 
conditions  and  will  be  turned  on  by  the  occurrence  of  this  option. 

10.6.16  Accept  Line  IDs  for  Special  Analysis  (Action  Code  SPECL).  Up 
to  10  line  IDs  can  be  designated  for  special  analysis  on  a  terminal 
session  basis,  i.e.,  from  line  connect  to  line  disconnect.  Each 
session  is  summarized  on  the  tabular  report  ID  RESPL. 

It  is  also  possible  to  obtain  histograms  for  these  special  lines.  In 
this  case,  both  tabular  reports  and  histograms  would  be  produced.  If 
the  histogram  option  is  selected,  the  user  must  insure  that  the  value 
of  "RPTCNT"  is  set  correctly  (see  subsection  10.6.1).  If  the  user 
wants  more  than  10  line  IDs  investigated,  the  internal  parameter 
"MXSPEC”  can  be  altered,  via  an  edit,  and  the  program  recompiled.  All 
occurrences  of  "MXSPEC"  must  be  changed.  For  each  integer  increase  in 
"MXSPEC",  and  additional  30  words  of  memory  is  required.  The  first 
card  contains  the  word  SPECL.  The  second  card  would  contain  the 
number  of  special  terminals  desired  and  the  third  card  would  contain  a 
list  of  terminal  IDs  separated  by  at  least  one  blank. 

The  terminal  IDs  should  be  expressed  as  a  2  character  field  followed 
immediately  by  an  H  or  N.  The  "H"  signifies  that  histograms  are 
desired,  while  the  "N~  signifies  that  no  histograms  are  desired. 

10.6.17  Modify  Threshold  Values  (Action  Code  -  THRESH).  This  option 
causes  a  warning  message  to  be  issued  whenever  the  event  count 
corresponding  to  any  HSLA  subchannel  exceeds  the  specified  threshold 
value  since  the  previous  trace  for  that  DATANET.  Two  threshold  values 
can  be  specified.  They  correspond  to  the  following  event  counts  on 
the  HSLA  subchannel:  transmits  and  receives.  The  default  values  for 
these  counts  are  initially  set  high  enough  that  the  warning  messages 
should  not  be  Issued.  In  addition,  the  user  may  request  that  a 
message  be  produced  every  time  the  number  of  buffer  denials  exceeds  a 
certain  value  or  the  number  of  available  words  of  buffer  space  falls 
below  a  certain  value.  This  information  is  provided  only  when  plots 
are  being  produced.  Figure  10-20  shows  the  cards  required  for  this 
action. 

10.6.18  Suppress  Honplot  Reports  for  Selected  Nets  (Action  Code  - 
HORPT ) .  This  option  allows  the  turning  off  of  all  reports  (other  than 
plots)  for  a  specified  DATANET.  Figure  10-21  shows  the  format  for 
this  action. 


Card  1  A 

Card  2  B 

Card  3  C  D 

Where 

A  -  The  letters  THRESH 

B  -  The  letters  AVAIL  If  we  are  setting  buffer  space  availability;  the 
letters  DENIAL  if  we  are  setting  buffer  denial  threshold;  or  the 
letters  HSLA  if  we  are  setting  HSLA  activity  thresholds. 

C,  D  -  Actual  threshold  values.  D  will  be  blank,  if  card  2  was  an 
“AVAIL"  or  a  "DENIAL"  card. 


Figure  10-20.  Threshold  Values 
(Action  Code  THRESH) 


Card  1  A 

Card  2  N 

Card  3  M  L  0  . . . 

Where 

A  -  The  letters  N'CRPT 

N  *  Number  of  DATANETs  appearing  on  the  Third  card,  whose  reports 
will  not  be  produced 

M,  L,  0  »  DATANET  numbers  whose  reports  are  to  be  turned  off. 

N  such  numbers  must  appear  on  card.  If  the  DATANET 
number  is  0,  the  0  must  be  punched  on  the  card. 


Figure  10-21.  Turn  off  Reports  For  Selected 
DATANETs  (Action  Code  NORPT) 
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10.6.19  Debug  (Action  Code  DEBUG).  Extensive  debug  facilities  are 
provided  within  the  program.  By  default  all  debug  is  turned  off. 

This  option  should  be  used  only  by  somebody  very  familiar  with  the 
logic  of  the  program.  Figure  10-22  shows  the  format  for  this  action. 

10.6.20  Alter  Histogram  Default  Parameters  (Action  Code  CHANGE).  The 
user  should  reference  section  10.4  for  a  discussion  of  Histogram 
Parameters.  Figure  10-23  provides  the  format  for  this  option. 

10.6.21  Unmatched/Duplicate  Error  Report  (Action  Code  DUPLIC).  In 
processing  response  time  data,  it  has  been  discovered  that  responses 
may  not  be  received  in  an  order  considered  correct  by  the  data 
reduction  program.  This  can  occur  because  of  a  lost  data  occurrence 
or  because  of  an  anomoly  in  the  functioning  of  the  DATANET-355.  The 
correct  order  and  an  explanation  of  the  responses  being  captured  are 
presented  in  sections  5. 2. 7. 7. 3,  5.4.8,  and  10.3  of  this  document. 
Normally,  when  this  error  occurs  an  error  message  will  be  produced. 
Table  10-2  shows  the  various  error  messages  that  may  be  produced  and 
describes  when  they  would  occur.  This  option  allows  the  user  to  turn 
off  these  error  messages,  or  else  produce  the  error  messages  only  for 
those  terminals  selected  for  special  analysis  (action  code  SPECL). 
Figure  10-24  provides  the  format  for  this  option. 

10.6.22  Special  Reject  Report  (Action  Code  REJECT).  Instances  occur 
when  the  H6000  will  reject  a  DATANET-355  request  for  service.  This 
rejection  normally  occurs  when  the  H6000  is  to  busy  to  immediately 
respond  to  the  355  interrupt-  In  these  cases  the  DATANET  will  be 
forced  to  retransmit  its  request-  When  this  event  is  detected,  the 
data  reduction  program  will  produce  a  reject  error  message.  In 
addition,  a  summary  of  the  number  of  such  rejects  may  also  be 
produced.  Under  default  conditions,  this  summary  report  is  not 
produced.  This  option  allows  the  user  to  turn  off  the  error  messages 
or  else  to  request  the  summary  report.  Figure  10-25  provides  the 
format  for  this  option. 

10. 7  JCL 

The  following  paragraphs  describe  the  JCL  usage  necessary  for  reducing 
a  GRTS-II  monitor  data  tape.  The  usual  $  SNUMB,  $  IDENT,  and  $  USERID 
cards  are  included  as  required  for  the  installation.  The  program  is 
controlled  by  the  following  JCL  cards: 

i  LOWLOAD 
$  OPTION  FORTRAN 
i  SELECT  B29IDPXD/OJBECT/GRT 
i  LIMITS  20, 48K.-2K, 10000 
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Card  1  A 

Card  2  B  C 

Where 

A  -  The  letters  DEBUG 

B  «  The  letters  TYPE1  If  type  1  and  type  3  records  are  to  be 
debugged;  or  the  letters  TYPE2  if  type  2  records  are  to 
be  debugged;  or  the  letters  BOTH  If  all  records  are  to  be 
debugged . 

C  »  DATANET  number  to  be  debugged 


Figure  10-22.  Debug  Option  (Action  Code  DEBUG) 
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Card  1  A 

Card  2  BCD 

Where 

A  =*  The  letters  CHANCE 

B  =  The  letters  LOW  if  the  low  value  is  modified  or  the 
letters  INTEV  if  the  interval  size  is  modified. 

C  *  Histogram  ID  to  be  modified  (see  table  10-1) 

D  =»  New  parameter 


Figure  10-23.  Alter  Histogram  Parameters 
(Action  Code  CHANGE) 
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Card  1  A 

Card  2  B 

Where 

A  «*  The  letters  DUPLIC 

B  =*  The  letters  Off  if  the  error  messages  are  not  desired 

at  all,  or  the  letters  TERM  if  the  error  messages  are  desired 
only  for  special  terminals 


Figure  10-24.  Unmatched/Duplicate  Error  Report 
(Action  Code  DUPLIC) 
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Card  1  A 

Card  2  B 

Where 

A  »  The  letters  REJECT 

B  -  The  letters  OFF  will  turn  off  the  reject 

error  message  but  produce  the  summary  reports. 

The  letters  BOTH  will  cause  the  error  messages  to 
be  produced  as  well  as  the  summary  report. 


Figure  10-25.  Reject  Report 
(Action  Code  REJECT) 
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The  run  time,  0.2  hour,  and  SYSOUT  limits,  10000  lines,  may  be  altered 
as  required  by  the  scope  of  the  monitored  run.  During  the  loading 
process,  the  program  will  reach  a  memory  size  of  56K,  but  the  extra  8K 
will  be  released  immediately  upon  loading. 

The  GRTS-II  monitor  data  tape  specifications  are  provided  by  the 
following  card: 

$  TAPE  01, X1D, .tape.no, .NO-RING 

The  TAPE  card  specifies  the  tape  type  (7-  or  9-track)  and  the  tape 
number. 

The  input  options  file  is  identified  by  a 
i  DATA  I* 

card,  followed  by  the  option  cards  as  described  in  section  10.6.  At 
least  one  data  card  containing  an  "END"  must  be  present. 

10.8  Multireel  Processing 

If  more  than  a  single  reel  of  data  has  been  collected  a  series  of 
messages  will  be  printed  at  the  computer  console  informing  the 
operator  that  a  new  data  reel  is  required.  The  following  are  the 
messages  produced. 

a.  DISMOUNT  REEL  # XXXXX  THEN  MOUNT  REEL  NUMBER  YYYYY  ON  ZZZZZ 

In  this  case,  XXXXX  is  the  old  reel  number,  YYYYY  is  the  new 
reel  number,  and  ZZZZZ  is  the  tape  drive  ID. 

If  the  operator  fails  to  mount  the  new  tape,  the  above  message 
will  be  repeated  three  times,  after  which  the  program  will 
terminate,  and  all  reports  produced. 

b.  IS  TAPE  XXXXX  MOUNTED  ON  DRIVE  ID  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  tape  number  being  requested  for 
mounting  and  YYYYY  is  the  tape  drive  ID. 

This  message  occurs  when  the  data  reduction  program  finds  the 
wrong  tape  has  been  mounted  (by  comparing  internally  generated 
tape  labels).  If  the  operator  answers  N,  the  message  in  (c) 
below  is  produced.  If  the  operator  answers  Y,  the  data 
reduction  program  will  terminate  and  all  reports  will  be 
produced.  In  this  case,  the  data  reduction  program  is  unable 
to  process  the  tape.  Even  though  the  operator  is  mounting  the 
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correct  cape,  the  internal  label  on  the  new  tape  does  not  natch 
that  being  requested  by  the  old  tape.  The  user  should  check, 
the  data  collection  session  to  insure  that  the  operator  did  not 
respond  with  an  incorrect  tape  number  during  multireel  change. 

After  entering  the  Y  or  N,  the  operator  will  need  to  hit  the 
EOM  key  twice  in  order  for  the  response  to  be  transmitted. 

c.  WRONG  REEL  JUST  MOUNTED,  DISMOUNT  AND  MOUNT  REEL  XXXXX  ON  ZZZZZ 

In  this  case,  XXXXX  is  the  new  reel  number,  and  ZZZZZ  is  the 
tape  drive  ID. 

d.  CAN  TAPE  XXXXX  BE  MOUNTED  ON  DRIVE  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  new  desired  reel  and  YYYYY  is  the 
tape  drive  ID. 

If  the  operator  fails  to  answer  this  message  it  will  be 
repeated  until  he  responds  with  a  "Y"  for  YES  or  ”N"  for  NO. 

If  he  types  in  "Y”,  then  message  (a)  will  be  repeated.  If  the 
types  in  "N",  then  the  program  will  be  terminated  and  all 
reports  will  be  produced. 

10. 9  Tape  Error  Aborts 

During  the  course  of  processing  it  is  possible  that  the  operator  will 
be  required  to  abort  the  data  reduction  program  due  to  an 
irrecoverable  tape  error.  If  such  a  condition  occurs,  the  operator 
should  abort  the  job  with  a  "U"  abort.  This  will  allow  the  data 
reduction  program  to  enter  its  wrap-up  code  processing  and  produce  all 
reports  generated  prior  to  the  tape  error. 
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SECTION  11.  CENTRAL  PROCESSING  UNIT  AND  TAPE  REDUCTION  PROGRAM  (CPUTRP) 


11.1  Introduction 

The  Central  Processing  Unit  and  Tape  Reduction  Program  f CPUTRP j  is  a 
FORTRAN  program  that  sequentially  processes  the  data  recorded  on  tape  by 
the  CPU  Monitor  and  the  Tape  Monitor  of  the  General  Monitor  Collector 

(GMC).  It  produces  a  number  of  reports  depicting  the  usage  of  the  CPUs  or 

the  usage  of  the  tape  subsystem  during  the  monitoring  period.  A  list  of 
these  reports  is  found  in  table  11-1  and  report  descriptions  are  presented 
i n  subsection  11.5. 

There  are  two  inputs  to  the  CPUTRP.  The  first  is  the  data  tape  produced 
by  the  CPU  Monitor  and/or  Tape  Monitor  in  the  General  Monitor  Collector. 
The  second  input  is  a  set  of  report  option  control  cards  used  to  alter  the 
reports  in  some  way  other  than  standard  default.  The  various  user  input 

options  and  their  formats  are  described  in  subsection  11.6.  The  actual 

reports  produced  by  the  CPUTRP  are  described  in  subsection  11.5. 

11.2  Data  Collection  Methodology 

The  CPUM  in  the  General  Monitor  Collector  will  create  its  own  direct 
transfer  trace  (type  70)  in  order  to  collect  data  sufficient  to  analyze 
the  utilization  of  the  Central  Processing  Units.  The  method  for 
generating  this  direct  transfer  trace  is  described  in  subsection  5.2.3  and 
the  formats  for  the  CPUM  generated  records  used  by  the  CPUTRP  are 
described  in  subsection  5.4.4. 

The  Tape  Monitor  in  the  General  Monitor  Collector  processes  GCOS  trace 
types  50,  51  and  52,  and  collects  information  to  monitor  the  usage  of  the 
tape  subsystem.  The  information  collected  on  the  occurrence  of  the  above 
traces  enables  the  CPUTRP  to  identify  the  jobs  using  tapes,  which  drives 
are  used,  how  long  a  job  is  delayed  due  to  nonavailability  of  tape  drives, 
and  the  length  of  time  a  job  is  allocated  to  a  given  drive. 

11.3  Analytical  Methodology 

There  is  no  special  analytical  procedures  used  in  this  program.  The 
program  merely  reports  on  the  usage  of  the  CPU  and  tape  subsystem  as  it  is 
reported  by  the  General  Monitor  Collector. 

11.4  Data  Reduction  Methodology 

The  CPUTRP  is  the  only  reduction  program  that  actually  produces  reports 
from  the  data  gathered  by  two  different  monitors  (CPU  and  Tape  Monitors). 
Therefore,  a  procedure  needed  to  be  developed  whereby  the  user  could 
specify  which  set  of  reports  he  desired,  or  if  desired,  allow  him  to 
produce  the  set  of  reports  from  each  monitor.  This  capability  could 
result  in  a  given  set  of  tapes  needing  to  be  analyzed  as  many  as  two  times 
within  a  given  run.  In  order  to  manage  this  dual  monitor  reporting 
capability,  a  more  complex  user  interface  was  required,  then  previously 


Table  11-1.  Central  Processing  Unit  and  Tape  Reduction  Reports  (Part  1  of  2) 
CPU  Reports: 

a.  A  periodic  tabular  report  which  shows  the  cumulative  CPU 
utilization  by  various  program  categories  (default  period  is  10 
minutes)  (10  #0). 

b.  An  integer  valued  histogram  of  the  number  of  system  activities  in 
the  CPU  queue  (ID  *1). 

c.  An  integer  valued  histogram  of  the  number  of  user  activities  in 
the  CPU  queue  (ID  #2). 

d.  A  real  valued  histogram  of  the  CPU  burst  length  for  user 
activities  (ID  #3). 

e.  A  real  valued  histogram  of  the  CPU  burst  length  for  all  activities 
(ID  #4). 

f.  An  ingeter  valued  histogram  of  the  number  of  system  activities 
with  outstanding  I/O  (ID  #5). 

g.  An  integer  valued  histogram  of  the  number  of  user  activities  with 
outstanding  I/O  (ID#  6). 

h.  An  integer  valued  histogram  of  the  number  of  system  activities 
with  CPU-I/0  overlap  (ID  #7). 

i.  An  integer  valued  histogram  of  the  number  of  user  activites  with 
CPU-I/0  overlap  (ID  #8). 

j.  An  ingeter  valued  histogram  of  the  number  of  inactive  activities 
in  core  (ID  #9). 

k.  A  periodic  plot  of  the  CPU  idle  time  (default  period  is  10 
minutes)  (ID  #10). 

kl.  A  periodic  tabular  report  of  WIN  CPU  usage  (default  period  is  10 
minutes)  (ID  #12). 

Tape  Reports: 

l.  An  integer  valued  histogram  of  the  number  of  tape  drives  in  use 
(time  corrected)  (ID  #11). 

m.  A  tabular  report  which  describes,  for  each  activity  that  used 
tapes,  the  device  and  channel  utilization  and  the  delay  time 
waiting  drives  (no  report  ID  #  assigned). 
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Table  11-1.  (Part  2  of  2) 


Execution  Reports: 

n.  A  report  which  provides  an  overview  of  the  data  reduction  -  It 
describes  the  initial  and  final  data  tapes,  the  card  input  options 
and  user  selected  time  frames  as  they  occur  (no  report  ID  # 
assigned). 

o.  A  report  which  shows  errors  detected  by  the  tape  handler,  and,  if 
selected,  debug  output  (no  report  ID  #  assigned). 

p.  A  report  which  shows  errors  detected  by  program  modules  other  than 
the  tape  handler  (no  report  ID  #  assigned). 


used  by  the  other  data  reduction  programs.  This  interface  will  be 
described  in  subsection  11.6. 

11.5  CRUTRP  Output 

Output  is  divided,  conceptually,  into  three  parts  -  Execution  and  Error 
Reports,  CPU  Reduction  Reports,  and  Tape  Reduction  Reports.  These 
categories  are  shown  in  table  11-1,  and  further  described  below.  An 
example  of  each  report  is  displayed,  and  a  simple  explanation  of  how  it 
was  derived  from  the  data  is  given. 

11.5.1  Execution  and  Error  Reports  (Files  6,  7  and  8).  These  reports  are 
written  to  three  files:  codes  <5,  7  and  8.  On  file  code  8,  the  user  will 
find  a  printout  containing  processing  or  execution  information  -  what  the 
CPU  and  Tape  Reduction  Program  found  on  the  data  tapes.  Included  in  this 
information  is  the  following: 

o  A  list  of  the  monitors  in  execution  during  the  GMC  data 
collection. 

o  An  echo  of  the  user  input  options,  and  the  program's 
interpretation  of  them. 

o  The  time,  date,  tape  number  and  RCSR  clock  at  the  beginning  of 
collection. 

o  If  the  timeframe  option  is  used,  a  report  of  when  the  various 
timeframes  were  reached. 

o  A  count  of  the  traces  reduced  within  each  timeframe  option. 

o  If  a  reduction  period  exceeded  9+  hours,  an  indication  that  a 

35-bit  internal  clock  overflowed  (no  error  implied). 

o  The  time,  date,  tape  number  and  RSCR  clock  at  end  of  data 
collection,  but  only  if  a  termination  trace  is  processed. 

o  When  the  NEW  option  is  user  selected,  the  items  above  are 
repeated  on  a  new  page. 

o  Version  number  -  The  software  that  is  compatible  with  this 

documentation  should  indicate  VERSION  7.2-10.64,  12  March  1982. 

A  sample  of  this  report  is  shown  in  figure  11-1. 

Errors,  except  for  tape  handler  errors,  are  listed  on  file  code  6.  Any 
such  occurrence  is  of  concern  to  C751  and  should  be  reported  for 
interpretation  and  corrective  action  (202-695-0856).  The  occurrence  of 
errors  will,  as  a  rule,  invalidate  the  run. 

All  tape  handler  messages,  including  tape  error  messages,  are  found  on 
file  code  7.  The  following  messages  are  of  informative  value  and  are 
generally  self  explanatory. 
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Figure  11-1.  Sample  Execution  Report 


0  "MOUNTING  ANOTHER  REEL  #..." 

0  "END  REACHED  IN  NXTREC  AT  RCDCHT  ..." 

Explanation:  A  tape  or  operator  error  forced  the  tape  handler  to 
treat  the  condition  as  an  end-of-file.  This  message  nay  be 
preceded  by  the  following 

o  “ERROR  ON  THE  TAPE  READ" 

0  "TAPE  MOUNTED  APPEARS  INCORRECT  BUT  IS  NEW  ...  PROCESSING  WILL 
CONTINUE  ..." 

Explanation:  A  newly  mounted  continuation  reel  does  not  conform 
to  continuation  conventions,  but  is  also  not  positively 
incorrect.  The  run  is  probably  invalid. 

o  "INCORRECT  TAPE  MOUNTED  3  TIMES  OR  NEXT  TAPE  CANNOT  BE  READ. 

RUN  ENDED". 

Explanation:  A  newly  mounted  continuation  reel  is  positively 
incorrect.  This  will  be  preceded  by 

o  "WRONG  TAPE  MOUNTED.  WANTED  ..." 

o  “JULIAN  DATES  DO  NOT  AGREE.  RUN  ENDED" 

Explanation:  A  new  physical  record  bears  an  incorrect  Julian 
date.  This  event  nay  result  from  re-using  an  old  GMC  data  tape 
in  another  collection  run  in  which  GMC  termination  was  improper 
or  incomplete. 

o  "GMFEXC  FOUND  END  OF  TAPE  ON  FIRST  READ" 

o  "GMFEXC  ERROR:  FIRST  RECORD  IS  IN  ERROR  OR  WRONG  TAPE  MOUNTED. 

PHYSICAL  RECORD  DUMPED". 

Explanation:  The  occurrence  of  this  message  is  of  concern  to 
C751  only  if  there  was  no  tape  mounting  or  tape  number 
confusion.  This  nay  be  preceded  by 

o  "GMFEXC  ERROR:  ASKED  FOR  TAPE  #...  GOT  ..." 

Explanation:  The  NEW  option  was  used,  and  the  user  specified 
tape  number  does  not  agree  with  the  number  found  on  the  NEW  tape. 

All  other  tape  handler  messages  are  of  concern  to  C751  and  should  be 
reported  for  correction. 

Debug  output,  when  selected,  shares  file  code  7  with  the  tape  handler. 

11.5.2  Central  Processing  Unit  Monitor  Reports.  The  CPU  title  page  is 
printed  to  file  code  14,  ianediately  ahead  of  any  histograms.  The  title 
page  contains  a  stmuary  of  the  systems  configuration,  the  time  reduction 
effectively  started  and  stopped,  as  well  as  Identifying  the  system  which 
was  monitored  and  the  tape  numbers  containing  the  data  set. 
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The  next  several  lines  of  output  describe  the  overhead  of  all  Gif  monitors 
that  were  active  during  data  collection.  The  monitor  name  is  given,  its 
CPU  tine  in  seconds,  and  its  overhead  as  a  function  of  total  processor 
power.  The  Gif  executive  overhead  is  separated  from  the  actual  monitors 
and  is  listed  as  "EXEC".  The  monitor  "NAflE"  is  an  area  of  code  within  the 
Mass  Store  Monitor  and  even  though  listed  separately,  it  is  also  included 
under  the  monitor  "MSM".  The  monitor  "FMS"  is  also  an  area  of  code  within 
the  Mass  Store  Monitor,  but  in  this  case  it  has  not  been  included  under 
the  monitor  "MSM*.  Monitor  "CM"  describes  the  processor  overhead  of 
subroutine  T4  (terminate  processing)  and  subroutine  T22  (start  I/O 
processing).  Monitor  "MSM"  describes  the  processor  overhead  of  subroutine 
T7  (connect  processing).  Therefore,  if  the  Channel  Monitor  was  active, 
but  the  Mass  Store  Monitor  was  not,  this  report  will  list  both  "CM",  “MSM" 
and  “FMS"  monitors.  If  both  the  Channel  and  Mass  Store  Monitors  were 
active,  then  the  combined  overhead  of  both  monitors  can  be  found  by  the 
same  sum  above.  For  purposes  of  this  report,  percent  overhead  is  computed 
as  (CPU  time  used  by  moni tor)/ (total  CPU  tine)  x  {number  of  processors). 

If  a  termination  record  is  not  reduced  for  any  reason,  the  lines 
describing  monitor  overhead  will  not  be  printed.  Figure  11-2  provides  a 
sample  report. 

11.5.2.1  Number  of  System  Activities/User  Activities  in  the  CPU  Queue 
(File  14).  Figures  11-3  and  11-4  (items  B  and  C  of  table  11-1)  show 
sample  histograms  of  how  busy  the  CPU  queues  were  and,  inferentially, 
whether  or  not  a  particular  work  load  was  I/O  or  CPU  bound.  They  indicate 
how  many  system  activities/user  activities  were  using  or  waiting  for  a 
processor  at  the  time  the  samples  were  taken.  The  count  includes 
activities  with  CPU-I/0  overlap. 

Note:  An  activity  is  a  system  activity  if  it  is  privileged  and  if  it  has 
no  J*  file  for  SYSOUT. 

All  histograms  produced  by  the  CPUTRP  are  interpreted  in  the  following 
manner: 

o  In  the  INDIV  NUMBER  column,  the  histogram  displays  the  number  of 
occurrences  of  a  particular  event.  The  particular  event  being 
evaluated  is  represented  by  the  figures  in  column  5.  Therefore, 
in  figure  11-3  we  see  that  231  times  the  CPU  queue  had  a  length 
of  0,  while  44  tines  the  queue  length  was  1. 

o  In  the  INDIV  PROB.  column,  the  histogram  displays  the  probabi  lity 
that  a  given  event  will  occur.  Therefore,  there  is  an  841 
probability  that  the  queue  length  was  0;  i.e. ,  84%  of  the  time 
there  was  no  queue,  while  16%  of  the  time  the  queue  length  was  1. 

o  The  CUMUL  NUMBER  and  CUMUL  PROB.  columns  are  merely  the 

cumulative  probability  distribution  of  the  histogram.  In  figure 
11-5,  we  find  that  40%  of  all  CPU  bursts  have  a  duration  of  6ms 
or  less  while  96.5%  of  all  CPU  bursts  have  a  duration  of  12ns  or 
less. 
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Figure  11-2.  CPU  Title  Page 
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Figure  11-3.  Number  of  System  Activities  in  the  CPU  Queue 


0 


The  last  line  of  the  histogram  provides  some  standard  statistical 
output  such  as  average,  variance  and  standard  deviations. 


11.5.2.2  CPU  Burst  Distribution  for  User  Activities/All  Activities  (File 
14).  Figures  11-5  and  11-6  (items  D  and  E  of  table  11-1)  show  sample 
histograms  of  the  CPU  burst  length  distribution  for  user  acti vi ties/all 
activities.  They  provide  a  measure  of  how  long  an  activity  held  a 
processor  before  relinquish  or  interrupt. 

WARNING:  Each  report  is  not  a  true  histogram  of  individual  burst  lengths 
but  is  one  of  burst  averages  over  a  sampling  period.  For  example,  figure 
11-6  shows  37062  bursts,  but  only  275  samples  were  taken.  Each  sample 
provided  a  count  of  intersample  bursts  and  the  accumulated  burst  time. 

For  each  sample,  the  histogram  was  charted  as  though  each  burst  had  the 
same  length,  namely,  the  average  intersample  burst  length  equals  the 
accumulated-burst-tine  divided  by  count-of-bursts. 

11.5.2.3  Number  of  System  Activities/User  Activities  in  Core  wi th 
Outstanding  I/O  (File  14]~!  These  two  histogram  reports  (items  F  and  G  of 
table  11-1 )  show  how  many  system  activities/user  activities  were  in  core 
with  outstanding  I/O.  Included  in  this  count  are  those  activities  with 
CPU- I/O  overlap.  See  figures  11-7  and  11-8  for  examples. 

11.5.2.4  Number  of  System  Activities/User  Activities  in  Core  with  CPU- I/O 
Overlap  (File  14)'.  These  two  histograms  ( i  terns"  H  and  I  of  table  11-1), 
samples  of  which  are  given  in  figures  11-9  and  11-10,  show  how  many  system 
activities/user  activities  were  both  in  a  CPU  queue  and  had  outstanding 
I/O  at  the  same  time.  These  histograms,  together  with  those  described  in 
subsections  11.5.2.1  through  11.5.2.3  provide  an  understanding  of  the 
CPU-I/0  balance  of  a  particular  workload  at  the  times  the  samples  were 
taken. 


11.5.2.5  Number  of  Inactive  Activities  in  Core  (File  14).  This  histogram 
report  (item  J  of  table  ll-l),  figure  11-11,  shows  the  count  of  activities 
in  core  that  were  neither  eligible  for  CPU  service  nor  were  waiting  I/O  at 
the  time  the  samples  were  taken. 

11.5. 2. 6  CPU  Time  Reports  (File  10).  This  tabular  report  is  produced 
every  ten  minutes  (default  period)  of  elapsed  time.  The  first  line 
indicates  how  many  seconds  have  elapsed  in  the  analysis,  the  total  CPU 
time  that  has  elapsed  (total  elapsed  time  x  the  average  number  of 
processors  available  through  this  period),  the  system  id,  time  of  day  and 
date.  The  amount  of  total  CPU  time  is  adjusted  for  any  processors  that 
have  been  released. 

The  next  block  of  print  gives  the  accumulated  CPU  time  for  each  system 
program,  for  TSS,  TRAX,  WIN,  and  for  all  slave  activities  (presented  as  a 
single  figure  under  the  heading  USER).  The  CPU  time  used  by  the  slave 
portion  of  the  GMC  collector  is  shown  separately  (heading  MONITR). 
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Figure  11-8.  Number  of  User  Activities  in  Core  with  Outstanding  1/0 


Figure  11-9.  Number  of  System  Activities  in  Core  with  CPU-I/0  Overlap 
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Figure  11-10.  Number  of  User  Activities  In  Core  with  CPU- I/O  Overlap 
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The  third  set  of  print  provides,  for  each  copy  of  Time  Sharing  (TSS),  the 
CPU  time  attributable  to  the  execution  phase  and  to  the  subdispatch 
phase.  In  addition,  for  each  copy  of  TSS,  the  average  service  time  is 
also  presented.  This  figure  is  represented  in  clock  pulses  (l/64ms). 

This  figure  represents  the  average  amount  of  CPU  time  used  by  TSS  whenever 
it  received  control  of  the  processor.  By  tracking  this  figure,  it  is 
possible  to  see  if  bad  periods  of  TSS  response  coincide  with  periods  of 
time  when  TSS  was  receiving  inadequate  time  slices  of  CPU  service.  The 
service  time  is  calculated  by  taking  the  total  CPU  time  accumulated  by  TSS 
and  dividing  it  by  the  total  number  of  CPU  bursts  accumulated  by  TSS. 

The  next  block  of  print  shows  the  amount  of  overhead,  idle  and  gate-loop 
time  accumulated  by  each  processor  and  by  total.  Gate-loop  data  is  not 
applicable  in  a  single  processor  environment.  Gate  loop  time  is  that 
amount  of  time  a  processor  is  locked  from  executing  because  another 
processor  has  locked  a  required  table  or  blocked  a  given  area  of  code.  In 
a  multiprocessor  environment,  there  are  many  instances  where  one  processor 
is  required  to  alter  the  values  in  a  given  table.  While  these  values  are 
being  changed,  the  system  wants  to  ensure  that  another  processor  does  not 
reference  the  table,  while  it  is  in  the  midst  of  being  changed.  To 
prevent  this  from  happening,  the  system  will  lock  the  table  while  it  is  in 
the  midst  of  being  altered.  If  a  second  processor  desires  to  reference  a 
locked  table,  it  is  required  to  execute  a  CPU  “dead"  loop  while  it  waits 
for  the  table  to  be  opened.  The  GLOGP  statistics  display  the  amount  of 
such  loop  time  executed  by  each  processor.  This  value  will  not  be 
reported  for  a  single  processor  environment  but  should  appear  for  any 
multiprocessor  environment  where  the  software  release  was  WW7.2/4JS.  If 
this  data  is  not  reported,  it  indicates  a  problem  with  the  GMF  collector 
and  CCTC  should  be  contacted. 

The  final  block  of  print  is  a  percentage  breakdown  of  CPU  usage  into  the 
categories  SYSTEM,  TSS,  TRAX,  WIN,  USER,  and  IDLE;  also  shown  are  the 
percentage  of  gate-loop  time  relative  to  processor  busy  time  and  the  time 
corrected  number  of  processors  in  use.  These  figures  are  printed  both  for 
the  current  10-minute  interval  and  for  the  total  current  reduction 
interval.  This  allows  the  user  to  track  when  peak  usage  of  CPU  power  is 
occurring  and  what  portion  of  the  system  is  using  this  power.  Figure 
11-12  provides  a  sample  of  this  report. 

Notes:  (1)  SYSTEM  time  includes  CPU  time  accumulated  in  the  "functions" 
OVERHEAD,  MISCELLANEOUS,  CALC,  PALC,  SYOT,  RTIN,  TDS,  LOGN,  FSYS,  DMTEX 
and  MONITR.  The  time  attributable  to  WIN,  TSS  and  TRAX  is  neither  SYSTEM 
nor  USER.  (2)  The  definition  of  overhead  time  is  the  time  spent  in  the 
interrupt  handler,  the  dispatcher  and  the  SWAP  processor,  plus  all 
gate-loop  time.  (3)  It  should  be  noted  that  the  percentage  figures  are 
based  on  total  CPU  power  and  therefore  add  up  to  100%  (excluding  the 
gate-loop  percentage).  In  order  to  determine  the  "amount  of  a  processor" 
required  or  used  by  a  given  function,  it  would  be  necessary  to  multiply 
the  percentage  figure  for  the  function  by  the  time  corrected  number  of 
processors  in  use. 
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Figure  11-13  shows  the  CPU  report  when  special  SNUMBs  were  selected  for 
monitoring.  In  this  case  it  was  desired  to  monitor  jobs  "AAAAA",  "ffiMMM", 
and  “FIVE  All  other  information  is  identical  to  that  described  in 
figure  11-12.  The  CPU  tines  listed  for  special  SNUMBs  are  also  included 
in  the  appropriate  category  under  the  heading  "CPU  TIME  USED  THUS  FAR...". 

11.5.2.7  CPU  Plot  of  Percent  Idle  (File  31).  This  plot  report  shows  the 
percentage  of  CPU  power  that  is  idle  during  each  10-mi nute  (default 
period)  interval.  The  data  is  taken  directly  from  the  CPU  Tine  Report 
described  in  subsection  11.5.2.6.  One  horizontal  line  is  output  for  every 
CPU  Tine  Report  table.  The  horizontal  line  represents  one  increment  on 
the  X-axis  and  it  "paints"  one  datum  of  percent  idle  and  the  change  of 
that  datum  since  it  v/as  last  plotted.  Every  10th  line  also  displays  the 
current  time  of  day.  By  the  nature  of  the  printing  mechanism,  an  ordinate 
position  is  a  cell,  a  range  of  values.  The  cell  width  is  specified  by  a 
DELTA  value  given  in  the  heading.  The  plot  contains  a  heading  line  giving 
the  system  id,  starting  tine  of  reduction  and  the  date.  It  also  contains 
the  report  title,  and  identifying  nark,  “A"  here,  of  the  curve,  and  the 
DELTA  value.  A  plot  summary,  if  not  user  deactivated,  follows  each  plot. 
Following  the  summary  is  the  overall  system  idle  percentage  in  three 
intervals;  zero  to  25®  idle,  25  to  50S  idle  and  50  to  100?®  idle.  A  final 
line  shows  the  plot  interval  in  seconds  (default  is  600  seconds).  Figure 
11-14  is  a  sample  of  this  plot. 

11.5.2.8  WIN  Report.  This  report  is  the  only  CPU  report  that  is  not 
produced  by  default  and  must  specifically  be  requested  with  the  use  of  the 
"ON"  option.  It  will  be  generated  under  the  same  time  interval  control  as 
is  used  for  the  CPU  Time  Report  (subsection  11.5.2.6)  (default  value  every 
10  minutes).  Figure  11-15  is  a  sample  of  this  report  (no  WIN  software  was 
active  at  the  time  this  sample  report  was  generated).  For  each  WIN 
program,  a  single  line  of  information  is  presented.  This  line  indicates 
the  total  amount  of  CPU  time  accunulated  by  the  program  during  the 
specified  time  interval,  the  number  of  CPU  bursts  accumulated  during  the 
time  interval  and  the  rate  (bursts/sec)  at  which  the  bursts  were 
generated.  This  report  can  be  used  to  track  those  periods  of  tine  when 
WIN  programs  were  using  excessive  CPU  tine  or,  on  the  other  hand,  were 
being  denied  CPU  service. 

11.5.3  Tape  Monitor  Reduction  Reports.  The  tape  reduction  title  page  is 
identical  to  the  CPU  reduction  title  page  (see  subsection  11.5.2),  except 
that  the  configuration  described  is  pertinent  to  the  tape  subsystem. 

Shown  are  the  channel  number,  the  IOM  nunber,  the  number  of  drives 
configured  to  the  channel,  the  type  of  drive  and  whether  the  drives  are 
cross-barred.  The  data  shown  is  the  configuration  as  presented  in  the 
boot  deck.  If  any  drives  have  been  taken  off  line  for  maintenance  or 
repair,  it  will  not  be  reflected.  The  title  page  precedes  any  histograms; 
an  example  is  presented  as  figure  11-16.  It  is  written  to  file  14. 
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Figure  11-15.  WIN  Report 
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Figure  11-16.  Tape  Reduction  Title  Page 


11.5. 3.1  Number  of  Tape  Drives  in  Use  (Tine  Corrected)  (File  14).  A 
histogram  report,  seen  as  figure  11-17,  shows  the  number  of  tape  drives  in 
use  at  the  sampling  epoch.  The  data  are  corrected  for  the  inter-sample 
period,  so  that  the  figures  listed  under  the  heading  "INDIV.  PR0B.“ 
correctly  represent  the  fraction  of  reduction  time  the  corresponding 
“NUMBER  (of)  DRIVES'*  were  in  use. 

11.5. 3.2  Tape  Activity  Report  (File  13).  This  tabular  report  is  made  for 
each  activity  of  a  job  that  used  tapes.  For  each  activity  of  a  job,  the 
tapes  used  by  that  activity  are  described  by  type,  unit  number,  and 
channel  number.  The  report  also  presents  how  long  the  activity  was 
delayed  in  peripheral  allocation  and  how  many  drives  it  was  waiting  for. 
The  final  print  tells  how  many  drives  were  in  use  when  the  activity 
started  and  how  many  were  in  use  when  it  ended.  At  the  right  margin  of 
the  report  are  tv/o  columns  of  numbers.  The  first  column  is  the  numerical 
sequence  in  which  the  activities  started,  and  the  second  column  is  the 
numerical  sequence  in  which  they  terminated.  Refer  to  figure  11-18  for  a 
sample  report. 

11.5.3.3  Tape  Status  Report  (File  12).  This  tabular  report  may  be  seen 
as  figure  1 1 -1 9.  It  shows  the  status  of  all  configured  tape  drives,  and 
is  repeated  each  tine  an  activity  was  delayed  due  to  unavailability  of 
tape  drives.  (The  first  report  entry  is  listed  with  the  initial  trace 
captured  by  the  monitor  collector).  The  reason  for  the  delay,  the  epoch 
of  the  delay  and  the  program  number  of  the  activity  delayed  are  printed. 

As  part  of  the  status  information,  the  following  is  presented: 

IOM-channel  number,  unit  number,  released  or  not,  assigned  or  not, 
dedicated  or  not,  used  for  TAD's  or  not,  number  of  errors  on  the  device, 
and  the  SNUM8  of  the  job  using  that  drive. 

11.6  Default  Option  Alteration 

The  CPU  and  Tape  Reduction  Program  uses  two  inputs.  The  first  is  the  data 
tape(s)  produced  by  the  GMC.  The  second  input  is  a  set  of  report  option 
control  cards.  The  various  options  and  their  formats  are  described  in  the 
following  subsections.  Report  option  control  cards  are  not  required  if 
the  default  options  are  acceptable  to  the  user. 

11.6.1  General  Format.  The  general  format  for  an  option  request  is  as 
f ol 1 ows : 

COMMAND  (PARAMETER -LI ST) 

where  COMMAND  is  a  keyword  specifying  what  action  is  to  be  taken  and 
(PARAMETER-LIST),  if  required,  provides  data  to  accomplish  the.  action. 

The  COWIAND  is  interpreted  through  its  sixth  character,  so  the  input  must 
match  the  first  six  characters  of  the  valid  commands  described  below. 
Shorter  commands  must  match  exactly. 
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Figure  11-18.  Tape  Activity  Report 
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Figure  11-19.  Tape  Status  Report 


Table  11-2.  Histogram  Default  Parameters 


REPORT  ID 

TRAILER  FLAG 

#  INTERVALS 

LOW  VALUE 

INTERVAL  SIZE 

1 

ON 

40 

0 

1 

2 

ON 

40 

0 

1 

3 

ON 

45 

0.0 

1.5 

4 

ON 

45 

0.0 

1.5 

5 

ON 

40 

0 

1 

6 

ON 

40 

0 

1 

7 

ON 

40 

0 

1 

8 

ON 

40 

0 

1 

9 

ON 

40 

0 

1 

11 

ON 

40 

0 

1 
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Table  11-3.  Plot  Default  Parameters 


#  POINTS  to  PLOT 
UNLIMITED 


Y-MINIMUM 

0.0 


Y- MAX I MUM 

100.0 
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11.6.1.1  Valid  Commands.  Eleven  commands  are  recognized  by  the  card 
input  interpreter.  The  chart  below  shows  each  command,  the  action  to  be 
taken,  and  in  parentheses,  the  default  i nplications. 


o  CPRIMT 

o  DEBUG 

o  HISTOGRAM 

o  NEW 

o  HPRINT 

o  ON 
OFF 

0  PLOT 

o  STOP 

o  TIMEFRAME 


Print  the  CPU  Time  Report  and  one  datum  of  the  CPU 
Idle  Time  Plot  (items  A  and  K  and  Kl  of  table  11-1)  at 
a  specified  repetition  period.  (Print  every  600 
second  s ) . 

Activate  the  debug  statements  in  one  or  more 
subroutines.  (All  debug  statements  are  inactive). 

Modify  a  histogram  report.  (Histogram  report 
parameters  are  as  shown  in  table  11-2). 

Prepare  to  accept  another,  or  repeat,  set  of  GMC  data 
tapes  and  another  set  of  option  alteration  commands 
for  a  following  reduction  run.  (Reduction  is  complete 
when  the  current  tape(s)  are  reduced). 

Print  the  histograms  only  if  the  reduction  interval 
is,  at  least,  a  specified  minimum.  (Print  the 
histograms  only  if  the  reduction  Interval  is  at  least 
900  seconds). 

(1)  Turn  on/off  one  or  more  reports.  (All  reports 
are  on  except  the  WIN  Report  (item  Kl  of  table 
11-1)  (ID  12)). 

(2)  Turn  on/off  tne  CPU  reduction  module  or  the  TAPE 
reduction  module  but  not  both.  (CPU  reduction  Is 
on;  TAPE  reduction,  off). 

Modify  a  plot.  (Plot  report  parameters  are  as  shown 
In  table  11-3). 

Stop  reduction  after  processing  a  specified  number  of 
physical  tape  records.  (No  limit). 

(1)  Accept  one  to  five  time  windows  for  overall  data 
reduction  or  for  plot  output.  (Data  reduction 
and  report  output  are  not  time  limited). 

(2)  Accept  one  to  five  time  windows  for  debug 
output.  (Debug  output  Is  not  time  limited). 

(3)  Treat  the  receipt  of  a  specified  or  implied 
special  record  as  the  end  of  one  timeframe  and 
start  of  another  -  that  is,  print  the  reports  and 
start  a  new  reduction  period  Immediately.  (No 
timeframe  action  Is  taken). 


i 
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o  TITLE  Accept  a  new  title  to  be  printed  on  all  reports  as  the 

new  banner.  ("CPU  AND  TAPE  REDUCTION,  VERSION 
7.2-10.64,  12  MAR  82"  is  printed  as  banner). 

11.6.1.2  Parameter  List.  The  parameter  list  is  a  sequence  of  data  items 
separated  one  from  the  next  by  a  field  of  spaces.  Any  one  space  in  the 
field  may  optionally  be  replaced  by  a  coma  or  colon.  A  data  item  may  be 
an  alphanumeric,  a  quoted  string,  an  integer,  a  real  number  or  a  null. 
Strings  are  enclosed  in  single  or  double  quotes.  Real  numbers  include  the 
standard  FORTRAN  forms:  for  example,  12.34,  1234E-2,  1.234+1  are  all 
accepted  as  the  same  number.  A  null  is  two  consecutive  commas  or  colons; 
it  stands  for  a  missing  data  item  and  for  the  separator  fields  on  either 
side  of  the  missing  item. 

11.6.1.3  Cocnand  Syntax.  Each  comand  with  its  parameter  list  must  be 
complete  on  a  single  card,  but  more  than  one  command  may  be  placed  on  each 
card  if  spaces  separate  them.  The  parameter  list  may  be  contiguous  with 
the  command  keyword  or  spaces  may  intervene.  The  syntax  for  each  command 
is  given  in  following  subsections.  The  data  acronym  RID  stands  for  a  one 
or  two  digit  integer  specifying  the  report  identification  number  of  the 
report  to  be  affected.  Report  identification  numbers  are  shown  in  table 
11-1.  The  specifications  “integer-W",  "alphanumeric-X",  "real-Y",  and 
"string-Z"  require  user  input  of  an  integer  number  in  a  field  at  most  “W" 
wide,  an  alphanumeric  in  a  field  at  most  "X"  wide,  a  real  number  in  a 
field  at  most  "Y"  wide  and  a  quoted  stri ng  in  a  field  at  most  "Z"  wide, 
respectively.  Alphanumerics  and  strings  exceeding  the  field  width  are 
accepted  but  are  truncated  to  the  right.  Integers  and  reals  exceeding  the 
specified  field  width  are  rejected  as  illegal  data.  Integers  may  not 
contain  a  decimal  point.  Reals  must  contain  a  decimal  point  or  an 
exponent.  Reals  are  limited,  for  all  data  input,  to  a  maximum  of  14 
characters  including  leading  sign,  decimal  point,  and  exponent.  Reals 
without  exponent  are  further  limited  to  a  maximum  of  11  characters 
including  leading  sign  and  decimal  point.  Data  items  shorter  than  the 
specified  field  width  are  entirely  acceptable  in  all  commands,  but  a  null 
item  is  acceptable  only  where  provided  for. 

11.6.1.4  General  Control  Command  Syntax.  The  CPU  and  Tape  Reduction 
program  permits  reduction  of  either  the  CPU  associated  traces  or  the  tape 
subsystem  associated  traces  during  one  pass  over  the  data  tapes.  The  CPU 
reduction  phase  is  on,  and  the  tape  reduction  phase  is  off,  by  default. 

The  following  commands  may  be  used  to  exercise  general  control  over  the 
reduction: 

o  DEBUG  Activates  all  debug  statements. 

o  DEBUG  (MODULE-NAME -1,.'..,  MODULE-NAME-N ) 

Activates  the  debug  statements  in  the  explicitly  named 
modules,  where  MODULE-NAME -1  is  the  FORTRAN  name  given 
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to  the  subroutine  or  function.  Only  the  first  six 
characters  are  interpreted.  The  routines  currently 
debuggable  are: 

CLOCK  -  keeps  the  master  clock 

FIGCHG  -  examines  a  reconfiguration  record  for 
CPU  related  change 

GETOKE  -  lexical  analysis  of  card  input 

LOGREC  -  gets  a  logical  record  meeting  reduction 
requirements 

NXTRECRD  -  tape  input  handler 

RECNFG  -  gets  the  initial  reconfiguration  trace 

TIMSET  -  sets  up  the  array  of  start-stop  times 
for  user  specified  reduction  windows 

The  one-shot  program  GMFEXC  which  reads  the  initial 
tape  record  is  executed  before  card  input.  It  may  be 
debugged  by  setting  program  switch  word,  bit  11  (i.e., 
0N6) . 

o  HISTOGRAM  (RID,  TRAILER- FLAG,  NUMBER-OF- INTERVALS,  LOW-VALUE, 
INTERVAL-SIZE) 

Turns  on  the  histogram  with  report  identification 
number  RID,  integer-2.  Print/don't  print  the 
histogram  suranary  if  TRAILER-FLAG  is  ON/OFF, 
alphanumeric-3.  The  new  number  of  histogram  intervals 
is  NUMBER-OF- INTERVALS,  integer-3.  The  new  low  value 
and  interval  size  are  LOW-VALUE  and  INTERVAL -SIZE  both 
integer-1 0  or  real -14  according  to  the  type  of 
histogram.  (In  the  current  version,  the  number  of 
intervals  may  not  exceed  50). 

The  following  two  options  are  as  above,  but  without  change  to  the 

current  specification  of  those  parameters  not  appearing  in  the  list. 

0  HISTOGRAM  (RID, .NUMBER-OF- INTERVALS,  LOW-VALUE,  INTERVAL-SIZE) 

0  HISTOGRAM  (RID,  TRAILER- FLAG) 

o  NEW  (TAPE-NUMBER) 

Flags  the  reduction  program  to  stop  reading  card  input 
options  and  to  proceed  with  data  reduction.  It  also 
informs  the  program  that  another  data  reduction  is  to 
follow,  and  that  the  following  reduction  is  to  lead 


off  with  the  tape  number  specified  by  this  option  (any 
six  characters).  For  that  following  reduction,  the 
default  options  will  prevail  unless  modified  by  option 
alteration  commands  following  the  NEW  command.  This 
command  must  be  the  last  command  on  a  card  (following 
commands  on  the  same  card  are  lost). 

o  HPRINT  (X)  Prints  histograms  if  reduction  interval  is  at  least  X, 
integer-10,  seconds.  Otherwise,  the  histogram  data 
are  lost. 

o  OFF  Turns  off  all  histograms  and  plots  (if  any). 

o  OFF  (RIO-1, ...,RID-n) 

Turns  off  the  reports  specified  by  report 
identification  numbers  RID-1 . RID-n. 

For  the  remaining  OFF  options,  the  first  two  characters  of  the 

parameter  are  necessary  and  sufficient. 

o  OFF  (PLOTS)  Turns  off  all  plots  (if  any). 

o  OFF  (HISTOGRAMS) 

Turns  off  all  histograms. 

o  OFF  (CPU)  Turns  off  the  CPU  reduction  phase  of  the  program  and 
turns  on  the  TAPE  reduction  phase. 

o  OFF  (TAPE)  Turns  off  the  TAPE  reduction  phase  and  turns  on  the 
CPU  phase.  This  is  the  default  specification  and  is 
not  likely  to  be  used,  but  is  included  here  for 
completeness. 

o  ON  ON  options  use  the  same  parameters  as  those  shown  for 

the  OFF  command,  with  appropriate  reversal  of  intent. 
All  reports  are  on  by  default  except  the  WIN  Report 
(item  Kl,  table  11.1,  ID  12)  which  is  off  by  default 
and  must  be  turned  on  with  this  option. 

Note:  CPU  and  tape  reduction  cannot  be  done  simultaneously.  To 

accomplish  both  reductions  in  a  single  job,  use  the  NEW  option 
and  a  form  of  the  ON/OFF  option:  ON (TAPE),  for  example. 

o  STOP  (X)  Stop  data  reduction  after  reading  X,  integer-10, 
records  maximum. 


o 


TIMEFRAME  (DEBUG 


I 


START  TI«,  STOP  TIME,  START  TIME,  STOP  TIME, 


Accepts  up  to  five  start/stop  pairs,  where  each 
component  of  the  pair  is  a  pseudo  decimal  number  (real 
7)  in  the  form  HHMM.SS  where  HH  is  the  hour,  MM  is  the 
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minute  and  SS  is  the  second.  The  decimal  point  must 
appear  on  the  card,  to  further  delimit  the  action  of 
debug  statements.  The  limiting  action  becomes 
effective  as  soon  as  the  program  determines  "what  time 
it  is."  This  command  must  be  accompanied  by  some  form 
of  the  DEBUG  command  or  no  debug  output  will  be 
produced.  The  timeframes  are  independent  of,  though 
not  unaffected  by,  any  other  user  selected  timeframes. 

o  TITLE  (X)  Accepts  the  string  X,  string-72,  as  the  new  banner  for 
all  reports.  X  must  begin  and  end  with  a  quotation 
mark,  single  or  double,  and  may  contain  any  FORTRAN 
acceptable  character  except  the  matching  quote  with 
which  it  is  delimited. 

11.6.1.5  CPU  Reduction  Command  Syntax.  In  addition  to  those  commands 
given  in  section  II .6. 1.4,  the  following  are  pertinent  to  the  CPU 
reduction  phase. 

o  CPRINT  (X)  Prints  the  CPU  Time  Report  and  one  datum  of  the  CPU 
percent-idle  plot  every  X,  integer-10,  seconds.  The 
specified  period  is  nominal  and  the  actual  period  will 
vary  with  trace  times.  This  command  will  not  affect 
the  on/off  status  of  these  reports. 

0  PLOT  (RID,  NUMBER-OF-POINTS,  Y -MINIMUM,  Y-HAXIMUM) 

Turns  on  plot  with  report  identification  number  RID, 
integer-2.  The  new  number  of  points  to  plot  is 
NUMBER-OF-POINTS,  integer-10,  maximum.  The  y-axis  of 
plot  is  bounded  below  by  Y-MINIMUM,  real -14,  and  above 
by  Y-MAXIMUM,  real -14. 

The  following  two  options  are  as  above,  but  without  change  to  the 

value  of  those  parameters  not  specified. 

o  PLOT  (RID,  NUMBER-OF-POINTS) 

0  PLOT  (RID,,  Y-MINIMUM,  Y-MAXIMUM) 

o  TI^FRAME  (RID,  START  TNC,  STOP  TIME,  START  TIME,  STOP  TIME,  ...) 

Turns  on  report  with  report  identification  number  RID, 
integer -2.  Sets  start  and  stop  tiroes  according  to  the 
pair 

START  TlfC,  STOP  TIME,  START  TIME,  STOP  TIME, 
where  each  component  Is  a  pseudo  decimal  number  (real 
7)  in  the  form  HHMM.SS  where  HH  is  the  hour,  MM  is  the 
minute  and  SS  is  the  second.  The  decimal  point  must 
appear  on  the  card.  Up  to  five  start/stop  pairs  may 
be  specified  for  a  given  report.  The  count  of  five 
may  be  achieved  In  one  or  several  commands;  however, 
the  times  must  be  in  increasing  order  in  order  to  get 
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the  results  wanted.  The  final  quadruple  in  a  connand 
may  be  abbreviated  -  if  only  a  start  tine  is  given, 
the  stop  tine  is  permanently  unbounded.  If  RID  is 
zero,  the  tineframe(s)  bound  the  entire  reduction  but 
the  status  of  individual  reports  (on  or  off)  is 
unaffected.  Histograms  may  not  be  individually 
delimited  with  this  connand,  thus  the  connand  affects 
the  entire  reduction  (RID  equals  zero)  or  the  CPU  plot 
( RID  equal s  10) . 

o  Tift  FRAME  (LOSTDATA) 

Treat  the  receipt  of  a  GMC  lost  data  trace  as  the  end 
of  one  timeframe  and  the  start  of  another. 

o  TIMEFRAME  Treat  the  receipt  of  a  reconfiguration  trace  in  which 
any  CPU  related  data  has  changed  (processor  has  been 
released  or  assigned)  as  the  end  of  one  timeframe  and 
the  start  of  another. 

11.6.1.6  Tape  Reduction  Command  Syntax.  In  addition  to  those  commands 
given  in  subsection  11 .6.1.3,  We" ToTTowi ng  is  pertinent  to  the  tape 
reduction  phase. 

o  TIMEFRAME  (0,0,0,  STOP  TIME) 

By  the  nature  of  its  construction,  the  Tape  Reduction 
Module  can  only  produce  a  nonwindowed  set  of  reports 
(items  M  and  N  of  table  11-1).  A  timeframe  set  for 
overall  reduction  (RID  equals  zero)  will  affect  only 
the  final  stop  time  for  these  reports.  The  start  time 
will  always  coincide  with  the  start  of  the  GMC 
collector.  For  consistency,  the  histogram  of  tape 
drive  use  (item  L  of  table  11-1)  will  cover  the  same 
period.  The  stop  time  must  be  in  the  same  format  as 
described  in  previous  timeframe  conmands. 

11.6.1.7  Card  Input  Errors.  If  the  card  interpreter  cannot  understand  a 
connand  keyword  or  data  item,  it  will  echo  the  entire  card  and  mark  the 
last  correctly  interpreted  character  position  with  the  message  "ILLEGAL 

COMMAND  (or  DATA)  FOLLOWING _ "  Depending  on  the  state  of  the 

interpreter,  it  may  attempt  to  find  the  end  of  the  incorrect  command  in 
order  to  pass  on  to  a  following  command  on  the  same  card,  or  it  may  reject 
the  remainder  of  the  card;  it  will  report  which  of  the  two  actions  was 
taken,  and  will  then  continue  with  card  interpretation.  In  no  case  will 
an  action  confirmed  by  the  interpreter  be  reversed  or  "undone"  by  a 
following  error.  Due  to  the-manner  in  which  cards  are  interpreted,  the 
JCL  file  used  to  execute  the  CPUTRP  should  have  the  line  numbers  removed 
prior  to  execution.  If  this  Is  not  done,  the  interpreter  will  try  to 
process  the  line  numbers  on  the  data  cards  as  valid  input  requests  and 
generate  error  messages  when  unable  to  do  so.  Despite  the  error  messages, 
the  CPUTRP  will  process  correctly. 
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11.6.1.8  Examples  of  Connand  Use.  A  few  examples  v/ill  show  the 
s i mpl i c i ty  of  the  scheme. 


0  ON  (99  1  5  2,  3,  6) 

Action:  Turns  on  reports  1,  2,  3,  5  and  6.  Report  99  doesn't 

exist,  so  that  parameter  is  ignored. 


o  ON  ("1",  002,  THREE,  4.0) 

Action:  Card  is  ignored  since  report  id's  are  not  one  or  two  digit 

i ntegers. 


o  TIMEFR  (0  2102.00,  2304.00,  0500.00) 

Action:  Sets  overall  data  reduction  window  to  start  at  2102  hours, 

stop  at  2304  hours,  and  start  again  at  0500  hours  with  a 
permanently  unbounded  stop  time. 


o  HISTOG  (12,  OFF,  42,  1.2,  1+4) 

Action:  If  report  ID  #12  is  a  histogram,  turns  the  trailer  print 

flag  off.  If  histogram  #12  is  of  the  real  continuous  type, 
turns  the  report  on,  sets  the  number  of  intervals  to  42, 
beginning  at  1.2  (Units)  with  each  interval  10,000.00 
(Units)  wide. 


o  NEW  (+A2345)  DEBUG  OFF  (PI) 

Action:  Tape  number  *A2345  is  remembered  to  be  the  lead  off  tape 

for  a  following  run.  Both  DEBUG  and  OFF (PL)  commands  are 
lost  since  they  appear  on  the  same  card.  If  these  commands 
are  desired  for  the  next  processing,  they  should  appear  on 
a  set  of  following  cards. 


o  DEBUG  DEBUG  (TIMSET) 

Action:  Turns  on  all  debug  statements.  DEBUG(TIMSET)  is  a  valid 

command,  is  correctly  Interpreted,  and  is  repetitious. 
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11.7  JCL 


The  CPU  and  Tape  Reduction  Program  is  controlled  by  the  following  JCL: 

$  SNUMB 

$  IDENT 

$  USERID  ...$... 

These  are  required  by  the  installation. 

$  SELECT  B29IDPX0/0BJECT/CPU-TAPE 

$  LIMITS  99,30K, ,20K 

These  two  cards  load  the  reduction  program  object  code  and  begin  execution. 
The  following  card, 

$  TAPEn  01 ,X1D, ,data-tape-number 

describes  the  tape  (7-  or  9-  track)  generated  by  the  data  capture 
procedure,  and 

$  DATA  05 

is  used  to  identify  the  data  cards  that  follow  and  that  specify  the  input 
options  as  described  in  subsection  11.6.1.  When  options  are  not  required, 
no  $  DATA  card  is  required. 

Figure  11-20  shows  a  sample  deck  setup. 

11.8  Multireel  Processing 

If  more  than  a  single  reel  of  data  has  been  collected,  a  series  of 
messages  will  be  outputted  to  the  console  informing  the  operator  that  a 
new  data  reel  is  required.  The  following  are  the  messages  produced. 

a.  DISMOUNT  REEL  #XXXXX  THEN  MOUNT  REEL  NUMBER  YYYYY  ON  ZZZZZ 

In  this  case,  XXXXX  is  the  old  reel  number,  YYYYY  is  the  new  reel 
number,  and  ZZZZZ  is  the  tape  drive  ID. 

If  the  operator  fails  to  mount  the  new  tape,  the  above  message 
will  be  repeated  three  times,  after  which  the  program  will 
terminate,  and  all  reports  produced. 

b.  IS  TAPE  XXXXX  MOUNTED  ON  DRIVE  ID  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  tape  number  being  requested  for 
mounting  and  YYYYY  is  the  tape  drive  ID. 
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IDENT 

18020251/30/3044 

MSG2 

THIS  JOB  WILL  USE  THE  FOLLOWING  TAPES 

MSG2 

IN  THE  GIVEN  ORDER,  ALL  RING-OUT 

MSG2 

AJ283,  AD281 ,  D0020 

SELECT 

B29I DPXO/OBJECT/CPU-TAPE 

LIMITS 

99,30K, ,20K 

TAPE 

01 ,X1D, ,AJ283, ,DATA 

DATA 

05 

DATA  cards 

ENDJOB 

Figure  11-20.  Sample  Deck  Setup 
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This  message  occurs  when  the  data  reduction  program  finds  the 
wrong  tape  has  been  mounted  (by  comparing  internally  generated 
tape  labels).  If  the  operator  answers  N,  the  message  in  (c) 
below  is  produced.  If  the  operator  answers  Y,  the  data  reduction 
program  will  terminate  and  all  reports  will  be  produced.  In  this 
case,  the  data  reduction  program  is  unable  to  process  the  tape. 
Even  though  the  operator  is  mounting  the  correct  tape,  the 
internal  label  on  the  new  tape  does  not  match  that  being 
requested  by  the  old  tape.  The  user  should  check  the  data 
collection  session  to  insure  that  the  operator  did  not  respond 
with  an  incorrect  tape  number  during  multireel  change. 

After  entering  the  Y  or  H,  the  operator  will  need  to  hit  the  EOM 
key  twice  in  order  for  the  response  to  be  transmitted. 

c.  WRONG  REEL  JUST  MOUNTED,  DISMOUNT  AND  MOUNT  REEL  XXXXX  ON  12221 

In  this  case,  XXXXX  is  the  new  reel  number,  and  ZZZZZ  is  the  tape 
drive  ID. 

d.  CAN  TAPE  XXXXX  BE  MOUNTED  ON  DRIVE  YYYYY  (Y/N) 

In  this  case,  XXXXX  is  the  new  desired  reel  and  YYYYY  is  the  tape 
drive  ID. 

If  the  operator  fails  to  answer  this  message  it  will  be  repeated 
until  he  responds  with  a  "Y"  for  YES  or  "N“  for  NO.  If  he  types 
in  "Y",  then  message  (a)  will  be  repeated.  If  he  types  in  “N", 
then  the  program  will  be  terminated  and  all  reports  will  be 
produced. 

11.9  Tape  Error  Aborts 

During  the  course  of  processing  it  is  possible  that  the  operator  will  be 
required  to  abort  the  data  reduction  program  due  to  an  irrecoverable  tape 
error.  If  such  a  condition  occurs,  the  operator  should  abort  the  job  with 
a  "UH  abort.  This  will  allow  the  data  reduction  program  to  entfcr  its 
wrap-up  code  processing  and  produce  all  reports  generated  prior  to  the 
tape  error. 
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SECTION  12.  TRANSACTION  PROCESSING  SYSTEM  DATA  REDUCTION  PROGRAM  (TPETG) 

12.1  Inc  roduct ion 

The  Transaction  Processing  System  Data  Reduction  Program  is  a  FORTRAN 
prograr  chat  sequentially  processes  the  data  tape  written  by  the  General 
Monitor  Collector  (CMC).  It  produces  several  reports  pertaining  to 
response  times  for  user/TPE  interactions,  in  order  to  help  the  site 
analyst  fine-tune  the  TPE  parameters  for  maximum  overall  efficiency.  A 
list  of  che  information  collected  is  found  in  table  12-1. 

12.2  Transaction  Processing  Svstem  Trace  Number 

When  work  on  the  TPS  monitor  began,  all  available  system  trace  numbers  (1 
to  77  octal)  were  used  either  by  the  dispatcher  itself  or  by  other  monitors 
of  the  GMF.  It  was  decided  to  use  trace  74  for  the  TPS  monitor,  as  this 
was  least  likely  to  cause  a  conflict. 

12.3  Transaction  Processing  Svstem  Trace  Collection 

Operator  messages  to  the  transaction  processing  system  are  routed  through 
the  core  allocator  (POPR).  To  avoid  altering  the  system  software  outside 
of  that  being  monitored,  the  TPS  monitor  is  turned  on  or  off  by  the  console 
operator  via  the  TP  MESS  command,  i.e.  ,  once  the  transaction  processing 
system  is  running,  the  operator  requests  "TP  MESS".  When  the  console 
responds  "TP  MESS?",  the  message  "TRACE  ON"  is  entered  to  start  collecting 
traces,  or  "TRACE  OFF"  to  discontinue  trace  collection. 

12.3.1  Sample  Decks.  Figures  12-1  and  12-2  are  sample  decks  for  collect¬ 
ing  TPS  traces.  Figure  12-1  is  a  compile  of  the  Generalized  Monitoring 
Facility  with  only  the  transaction  processor  data  collector.  Figure  12-2 
illustrates  a  run  of  that  program.  Figure  12-21,  at  the  end  of  this 
section,  lists  the  alters  that  must  be  incorporated  into  the  WWMCCS 
transaction  processing  system  in  order  to  collect  the  GMF  traces. 

12.4  TPE  Tuning  Guide  Reports 

This  section  and  the  following  section  will  contain  the  running  instruc¬ 
tions  for  producing  the  TPE  reports.  There  are  two  separate  programs 
producing  two  separate  sets  of  outputs.  This  section  deals  with  the 
Tuning  Guide  reports,  and  the  following  section  deals  with  the  Tuning 
Guide  formatted  dump.  Both  sections  will  also  contain  the  input  and 
output  formats. 

12.4.1  Input .  To  produce  the  Transaction  Processing  Tuning  Guide  Reports 
from  the  TPE  System  tape,  the  program  B29IDPXO/OBJECT/TPETG  must  be  run. 
Input  parameter  cards  may  be  used.  They  must  be  inserted  immediately 
after  the  $DATA  I*  card  in  the  JCL.  If  the  input  parameter  cards  are 
omitted,  all  the  data  will  be  reported.  The  input  option  consists  of 
START/STOP  times  for  the  reports.  The  first  card  gives  the  number  of 
times  to  follow  on  the  second  card.  The  second  card  contains  a  maximum 

of  5  pairs  of  START/STOP  times.  The  input  is  in  free  format.  A 
description  of  each  follows. 
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Table  12-1.  Transaction  Processing  System  Traces  (Part  1  of  2) 
SUBTRACE 

NUMBER  INFORMATION 

TRXD 

1  TPE  scans  terminals  for  a  connect  request 

2  TPE  connects  a  new  terminal 

3  TPE  notices  a  break  request  from  user 

4  TPE  disconnects  a  terminal 

5  Number  of  UNDOT  table  entries  increases  or  decreases  by  1. 

UNDOT  is  an  acronym  for  UNDelivered  OuTput.  If  a  user  runs 
a  TPAP  that  returns  information  to  the  terminal,  but  the 
terminal  is  busy  or  disconnected  when  the  output  is  ready 
for  transmission,  the  output  is  saved  until  that  terminal 
becomes  available  (DD36B  ,p3-l 5) .  If  memory  is  unavailable, 
the  undelivered  output  is  written  to  the  journal  file  (if 
present) 

6  Reason  that  TPS  is  unable  to  continue  and  is  about  to  abort 
itself 

7  Name  of  TPAP  (Transaction  Processing  Applications  Program) 
spawned  at  user  request 

8  Name  of  TPAP  removed  from  "quick-access"  file  in  order  to 
spawn  another  TPAP  requested  by  user 

9  Number  of  blocks  of  buffer  space  acquired  by  TPE,  via  a  MME 
GEMORE,  in  order  to  run  a  TPAP  requested  by  user 

10  Number  of  blocks  of  buffer  space  refused  to  TPAP,  i.e.  that 
TPAP  cannot  be  run  at  this  time  due  to  insufficient  core 

11  Invalid  keyword  (request  for  a  specific  TPAP)  entered 

13  Number  of  blocks  of  buffer  space  released  after  the  specified 
TPAP  has  finished  running 

14  Output  transmitted 

16  One  entry  of  undelivered  output  (see  #5  above)  has  been 
retrieved  from  temporary  storage  on  the  journal  file 

17  INTERCOM  message  (message  sent  from  one  TPAP  to  another)  is 
reissued,  because  confirmation  that  message  was  received  did 
not  arrive  at  sending  TPAP.  The  need  to  resend  a  message 
could  indicate  a  line  problem  or  a  hardware  problem 

18  TPAP  receives  INTERCOM  line,  enabling  TPAP-to-TPAP  communication 
to  commence 

19  Write  instruction  performed  by  a  TPAP 

20  Read  instruction  performed  by  a  TPAP 

21  Snumb  of  TPAP  which  terminates  abnormally  due  to  operator 
intervention  or  because  TPS  terminates 

22  Snumb  of  TPAP  which  terminates  abnormally  due  to  some  error 
within  the  TPAP  itself 
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Table  12-1.  (Part  2  of  2) 


SUBTRACE 

NUMBER  INFORMATION 

TRXC 

31  Request  for  TPAP  status 

32  Table  reaching  threshold  size  and  the  number  of  times  this 
table  has  reached  threshold  size.  The  TPE  threshold  and 
impasse  traces  are  taken  when  these  messages  are  sent  to  the 
operator’s  console  (DD36A,  p.6-19).  Thresholds  are  error 
conditions  correctable  by  TPE.  For  instance,  if  an  output 
buffer  is  full,  TPE  will  direct  output  to  the  online  printer 
to  prevent  an  overflow  situation.  Threshold  conditions  are 
counted.  When  the  count  reaches  certain  predetermined  levels, 
the  operator  is  informed  and  a  trace  taken.  The  number  of 
threshold  conditions  can  be  reduced  by  adjusting  the  buffer 
sizes  specified  in  the  .TPC.  macro  (DD36,  p.  6-10).  If  TPE 
encounters  an  error  condition  from  which  it  cannot  recover, 

it  notifies  the  operator  that  it  has  reached  an  impasse  and 
terminates  itself. 

33  Master  terminal  sign-on  accepted 

34  IDs  of  master  terminal  and  second  terminal  attempting  to 
sign  on  as  a  master  terminal 

35  Master  terminal  disconnect 

40  Compression  of  TPAP  information  within  TPS's  core  space 
attempted.  ITiis  is  done  only  when  the  master  terminal  operator 
is  entering  dynamic  information  for  a  new  TPAP  and  there  is 
insufficient  contiguous  storage  available 

41  Name  of  new  TPAP  being  dynamically  entered  into  TPS  from 
master  terminal 

42  Name  of  TPAP  being  dynamically  removed  from  TPS  from  master 
terminal 

43  Name  of  TPAP  being  modified  by  master  terminal  user 

44  Command  issued  at  operator  console 

45  Command  Issued  at  master  terminal 

52  Initial  buffer  sizes  of  major  TPS  files 
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$  FILEDIT  SOURCE, OBJECT, INITIALIZE, NONE 

$  DATA  *C  .COPY 

$  LOWLOAD 

$  OPTION  ERCNT/500/ 

$  GMAP  NDECK .NLSTOU 

$  SELECTA  B29IDPXO/GMFCOL/Q4F/©tF.TOP 

$  SELECTA  B29IDPXO/GMFCOL/TPE/TP. INIT 

$  SELECTA  B29IDPXO/GMFCOL/GMF/GMF.MID 

$  SELECTA  B29IDPX0/GMFCOL/GMF/GMF.MON 

$  SELECTA  B29IDPX0/ GMFCOL/GMF/ GMF .BTM 

$  GMAP  NDECK, NLSTOU 

$  SELECTA  B29IDPX0/GMFC0L/TPE/TPE200 

$  EXECUTE 

$  ENDEDIT 

$  ENDCOPY 

$  PRMFL  R*,R/W,S,B29IDPXO/GMFCOL/GMF.OBJ 


Figure  12-1.  TPS  GMF  Compile  JCL 
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<r>  <r>  </>  </>  </>  </>  <j>  <f>  </> 


OPTION  ERCNT/500/ 

LOWLOAD 
EXECUTE  DUMP 

PRMFL  R*,R,S,B29IDPXO/GMFCOL/GMF.OBJ 
LLMITS  15.16K 
PRIVITY 

TAPE  OT.X2D ,  , ,  .RING-IN 
FILE  DK.X1R.300R 

DATA  I* 

MO  Ml  M2  M3  M4  M5  Mo  M8 


Figure  L  2—2 


Control  Cards  for  Running  Only  the  TPS  GIF 


o 


START  -  This  is  a  time  of  day  on  a  24  hundred  hour  clock.  The 
format  is  HH:MM.  It  can  be  used  to  skip  the  printing  of  traces 
created  before  a  certain  time.  The  data  for  the  traces  skipped 
will  not  be  reported  at  all.  To  start  at  the  beginning  of  the 
tape  when  using  a  STOP  time,  use  00:00  for  the  START  time. 

o  STOP  -  This  is  also  a  time  of  day  on  a  24  hundred  hour  clock. 
The  format  is  It  can  be  used  to  skip  the  printing  of 

traces  created  after  a  certain  time.  The  data  for  the  traces 
skipped  also  will  be  eliminated  from  all  reports.  At  midnight, 
the  clock  will  rollover  to  00;  so  this  time  may  be  less  than 
the  START  time. 

An  example  of  the  input  cards  are  as  follows: 

2  (Card  1) 

22:00,23:30  (Card  2) 

After  inserting  the  options  desired,  the  $  TAPE  card  must  be  altered  to 
insert  the  TPE  Data  Collector  tape  number  before  executing  the  program. 

A  list  of  the  JCL  is  shown  in  figure  12-3. 

12.4.2  Output.  Up  to  15  reports  can  be  produced  by  this  program.  If 
no  data  pertaining  to  a  particular  report  is  found,  the  report  is  not 
produced.  All  16  reports  listed  here  are  written  to  report  code  08. 
Example  reports  are  shown  in  figures  12-4  through  12-18.  A  list  of  each 
report  with  its  description  follows. 

12.4.2.1  TPE  Summary  Report.  This  report  includes  the  total  number  of 
reads,  writes,  invalid  keywords,  keyword  table  suppression  attempts  and 
TPAPs  termed.  Also  included  are  the  maximum  number  of  UNDOT  (undelivered 
output)  entries  encountered  and  the  overall  time-weighted  average  number. 
The  maximum  number  is  the  largest  number  of  entries  in  the  trace  5  (UNDOT 
Table  Change).  The  trace  5  obtains  the  number  of  entries  from  the  UNDOT 
table  every  time  a  change  is  made  to  the  table.  The  average  is  the  sum 
of  the  number  of  entries  of  each  trace  5  times  the  corresponding  time 
Interval  divided  by  the  sum  of  the  time  intervals. 

The  minimum,  maximum  and  time-weighted  average  number  of  terminals  on 
TPE  are  reported,  where  the  minimum  number  is  the  least  number  of 
terminals  connected  at  any  one  time  and  the  maximum  number  is  the  most 
terminals  connected  at  any  one  time.  These  numbers  are  obtained  by 
adding  the  terminal  connect  traces  (2)  and  subtracting  the  terminal 
disconnect  traces  (4).  The  average  is  the  sum  of  the  number  of  terminals 
(trace  2  or  4)  times  the  corresponding  time  interval  divided  by  the  sum 
of  the  time  intervals. 

The  minimum,  maximum,  and  average  interval  in  seconds  between  connect 
request  scans  are  reported,  where  the  minimum  interval  is  the  least 
amount  of  time  between  terminal  connect  request  scans  (trace  1)  and  the 
maximum  interval  is  the  largest  amount  of  time  between  terminal  connect 
request  scans.  The  average  is  the  sum  of  the  time  intervals  divided  by 
the  total  number  of  scans.  Seven  different  buffer  tables  (see  12.4.2.5) 
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LOWLOAD 

SELECT  B29IDPX0/03JECT/TPETG 

LOWLOAD 

EXECUTE  DUMP 

MSG2  1, PLEASE  ENTER  "U"  IF  TAPE 

MSG2  1  .ERRORS  OCCUR 

LIMITS  10.45K.-2K.30K 
FFILE  P* ,LGU/ (06 ,08,09,29 ,42) 

FFILE  10 .NSTDLB .NOSRLS .BUFSIZ/4094 .FIXLNG/4094 .ERRXIT/KILLFM 
TAPE  10, X1D,,,, NO-RING 

DATA  I* 

30 

ENDJOB 


Figure  12-3.  JCL  for  TPE  Data  Reduction 


and  the  initial  buffer  sizes  in  blocks,  the  total  number  of  thresholds 
reached  by  each  buffer  are  produced. 


Lastly  ,  the  minimum,  maximum,  average  interval  in  seconds  between  break 
requests  encountered  are  also  reported.  The  minimum  interval  is  the 
least  amount  of  time  between  noticed  break  requests  (trace  3)  and  the 
maximum  interval  is  the  largest  amount  of  time  between  noticed  break 
requests.  The  average  is  the  sum  of  the  time  intervals  divided  by  the 
total  number  of  noticed  break  requests.  See  figure  12-4. 

12.4.2.2  NONEW  Option  Report.  This  report  lists  the  times  in  hours, 
minutes  and  seconds  that  an  operator  console  request  or  master  terminal 
request  of  NONEW  (do  not  accept  new  terminals/t ransactions)  or  NEW 
(equivalent  of  NONEW  off)  was  encountered.  See  figure  12-5. 

12.4.2.3  Profile  ID  Report.  This  report  lists  profile  IDs  and  the  time 
in  hours,  minutes  and  seconds  that  each  was  either  stored  or  erased.  A 
TPAP  profile  is  information  assembled  into  the  Transaction  Processing 
Executive,  consisting  of  the  TPAP  name,  keywords  (entry  points),  I/O 
buffer  sizes,  and  option  flags  (DD41,  p.4-8).  See  figure  12-6. 

12.4.2.4  Buffer  Space  Report.  This  report  lists  the  times  in  hours, 
minutes  and  seconds  that  blocks  were  either  acquired  or  released,  and 
the  number  of  blocks  acquired  or  released  each  time.  Each  block  is  64 
words.  See  figure  12-7. 

12.4.2.5  Table  Reaching  Threshold  Size.  This  report  lists  the  buffer 
table  names  and  the  time  in  hours,  minutes,  and  seconds  that  table 
threshold  size  was  reported  to  the  operator  ("TPE  THRSHLD  ON  IP  xx  LK 
xx  RY  xx  OT  xx  TR  xx  UD  xx  DB  xx").  This  message  is  issued  when 
requested  by  the  operator  or  the  master  terminal  user,  when  TPE  termi¬ 
nates  (unless  all  counts  (xx)  are  zero),  and  when  any  count  reaches  a 
predetermined  value.  The  standard  values  are  8,  64,  512,  4096,  32768, 
262144.  The  message  refers  to  the  INPUT  (buffer  for  input  buffer  assign¬ 
ment,  DD36,  p.A-3) ,  LINK  (message  queue  entries,  DD36,  p.A-3) ,  RECOVY 
(recovery  table,  DD36,  p.A-5),  OUTBUF  (output  buffer  queue  area,  DD36, 
pp.a-6,7),  TRABUF  (transmission  buffer  queue  area,  DD36,  p.A-8) ,  UNDOT 
(undelivered  output  catalog,  DD36,  p.A-9) ,  and  dynamic  INTERCOM  (inter¬ 
slave  communications  facility,  DD41,  chapter  5)  buffers.  See  figure 
12-8. 


12.4.2.6  Master  Terminal  Report.  This  report  lists  the  Master  terminal 
IDs,  the  sign-on  times,  the  disconnect  times,  other  terminal  IDs 
attempting  sign-on  and  those  times.  All  'imes  are  in  hours,  minutes, 
and  seconds.  See  figure  12-9. 

12.4.2.7  Impasse  Report.  This  report  lists  the  time  in  hours,  minutes, 
and  seconds  that  an  impasse  occurred  in  TPS,  and  an  error  message  was 
sent  to  the  operator's  console.  Possible  problem  areas  are  LINK,  RECOVY, 
OUTBUF,  TRABUF,  UNDOT,  INPUT,  and  JC-STS.  The  first  six  names  specify 
tables  in  which  the  fault  may  have  occurred  and  are  described  in  para¬ 
graph  12.4.2.5  above.  JC-STS  refers  to  an  unrecoverable  error  on  a 
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Figure  12-7.  Buffer  Space  Report  (Part  1  of  2) 
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journal  file,,  and  should  actually  appear  as  JI-STS  for  the  JOUR-IN  file 
or  JO-STS  for  the  JOUR-OUT  file  (DD36,  p.3-5).  Suggestions  for  avoiding 
IMPASSE  faults  are  described  on  page  6-19  of  the  Transaction  Processing 
System  Site  Manual  (DD36).  See  figure  12-10. 

12.4.2.8  Output  Transmission  Report.  This  report  lists  the  terminal  IDs 
that  received  output,  the  time  transmitted  in  hours,  minutes,  and  seconds 
and  the  record  pointers  indicating  the  starting  address  within  TPS  of  the 
output  buffer.  See  figure  12-11. 

12.4.2.9  TPAP  ABORT  Report.  This  report  lists  the  TPAP  transaction 
numbers  that  aborted,  the  time  that  it  aborted  in  hours,  minutes,  and 
seconds  and  the  reason  for  aborting.  See  figure  12-12. 

12.4.2.10  UNPOT  Entry  Report.  This  report  lists  the  times  in  hours, 
minutes,  and  seconds  that  an  UNDOT  (undelivered  output)  entry  was 
retrieved  from  the  journal  file.  See  figure  12-13. 

12.4.2.11  Reissuing  Intercom  Message  Report.  This  report  lists  the  time 
in  hours,  minutes,  and  seconds  and  the  snurabs  of  programs  reissuing  an 
intercom  message  between  TPE  and  the  TPAPs  or  between  TPAPS.  See  figure 
12-14. 


12.4.2.12  Receiving  Intercom  Message  Report.  This  report  lists  the  time 
in  hours,  minutes,  and  seconds  and  program  names  receiving  an  intercom 
message.  See  figure  12-15. 

12.4.2.13  TPAP  Modify  Report.  This  report  lists  each  TPAP  modified,  the 
modify  code,  and  the  time  modified  in  hours,  minutes,  and  seconds.  The 
items  that  can  be  modified  are  keywords,  priority,  flags,  and  buffers. 

See  figure  12-16. 

12.4.2.14  TPAP  Status  Report.  This  report  lists  TPAPs  of  which  the 
status  was  requested  by  the  master  terminal.  The  status,  the  status 
code  and  the  time  in  hours,  minutes,  and  seconds  the  status  was  requested 
are  also  printed.  See  figure  12-17. 

12.4.2.15  TPAP  Run  Times  Report.  This  report  lists  all  TPAPs  that  have 
started  and  ended  within  the  time  limit  of  this  data  reduction  run. 

Listed  are  the  start  and  stop  times  in  hours,  minutes,  and  seconds,  the 
elapsed  time  in  seconds,  and  the  processing  time  in  seconds.  A  blank  EOJ 
status  indicates  normal  termination.  "ABORTED"  indicates  the  TPAP 
aborted.  "TERMED"  indicates  the  TPAP  was  terminated  by  an  operator. 

See  figure  12-18. 
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12.5  TPE  Tuning  Guide  Formatted  Dunp 

This  seccion  will  contain  the  running  instructions  for  producing  the  TPE 
Tuning  Guide  formatted  dump.  It  will  also  include  the  input  and  output 
formats. 


12.5.1  Input .  To  produce  the  Transaction  Processing  Tuning  Guide 
formatted  dump  from  the  TGP  System  tape,  the  file  B29IDPXO/OBJECT/ 

TPEDUMP  must  be  run.  Input  parameter  cards  may  be  used.  They  must 
be  inserted  immediately  after  the  $  DATA  I*  card  in  the  JCL.  If  the 
input  parameter  cards  are  omitted,  all  the  data  will  be  dumped.  There 
are  five  input  options  available:  MAXOUT,  TIME,  SKIP,  OPTION,  and  LIMIT. 
The  first  card  has  the  input  option  type  to  follow  (e.g.  MAXOUT).  The 
second  card  gives  the  number  of  entries  to  follow  on  the  third  card 
(applies  only  to  the  TIME  and  LIMIT  options).  The  third  card  contains 
the  input  parameter.  The  input  is  in  free  format.  A  description  of 
each  follows. 

o  MAXOUT  -  This  option  is  a  limit  to  the  i—  t<mii»  number  of  traces 
to  be  printed.  Even  though  the  data  will  not  be  printed,  it 
still  will  be  collected  for  the  summary  report.  The  default 
is  30,000.  The  second  card  will  contain  the  new  limit. 

o  TIME  -  This  is  a  time  window  option.  The  second  card  is  used 
for  this  option.  It  gives  the  number  of  times  to  follow.  The 
third  card  contains  a  maximum  of  5  pairs  of  START/STOP  times. 

a.  START  -  This  is  a  time  of  day  on  a  24  hundred  hour  clock. 
The  format  is  HH:MM.  It  can  be  used  to  skip  printing 
traces  created  before  a  certain  time.  The  data  for  the 
traces  skipped  will  also  be  collected  for  the  summary 
report.  To  start  at  the  beginning  of  the  tape  when 
using  a  STOP  time,  use  00:00  for  the  START  time. 

b.  STOP  -  This  is  a  time  of  day  on  a  24  hundred  hour  clock. 

The  format  is  HH:MM.  It  can  be  used  to  skip  printing 
traces  created  after  a  certain  time.  The  data  for  the 
traces  skipped  will  also  be  skipped  for  the  summary 
report.  At  midnight,  the  clock  will  rollover  to  00;  so 
this  time  may  be  less  than  the  START  time. 

o  SKIP  -  This  option  is  for  skipping  traces  before  printing  is  to 
begin.  The  data  for  these  traces  will  also  be  collected  for 
the  summary  report.  The  default  is  0.  The  second  card  will 
contain  the  number  of  traces  to  be  skipped. 

o  OPTION  -  This  is  a  print  option.  If  this  option  is  not  present, 
the  traces  will  be  printed.  If  present,  only  the  summary  report 
will  be  printed.  No  additional  cards  are  required. 

o  LIMIT  -  This  option  is  a  limit  to  the  maximum  number  of  a 

particular  trace  type  to  be  printed.  The  second  card  is  used 
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for  this  option.  It  gives  the  number  of  trace  types  to  follow. 
The  third  card  contains  FIRSTX  and  the  trace  types  (NOPRNT). 

a.  FIRSTX  -  This  works  in  conjunction  with  the  NOPRNT.  It 
determines  how  many  to  print  of  each  trace  type  specified 
in  NOPRNT.  The  default  Is  0. 

b.  NOPRNT  -  This  specifies  up  to  10  trace  types  for  which  the 
printing  can  be  limited.  The  default  is  0. 

Examples  of  the  input  cards  are  as  follows: 

example  A 
MAXOUT  (card  1) 

40000  (card  2) 

example  B 
OPTION  (card  1) 

example  C 
LIMIT  (card  1) 

2  (card  2) 

100  1,3  (card  3) 

In  example  A  the  user  is  setting  the  maximum  number  of  traces  to  be 
printed  at  40,000.  In  example  B  the  user  is  eliminating  printing  the 
traces  and  only  the  summary  report  will  be  printed.  In  example  C  the 
user  is  printing  only  100  each  of  trace  type  1  and  trace  type  3. 

After  choosing  the  options  desired,  thd  $  TAPE  card  must  be  altered  to 
insert  the  TPE  Data  Collector  tape  number  before  executing  the  program. 

A  list  of  the  JCL  is  shown  in  figure  12-19. 

12.5.2  Formatted  Output.  The  formatted  output  contains  the  TPE  trace 
number  in  decimal,  and  the  TPE  trace  number  (in  octal)  in  the  first  half 
of  the  first  word  and  the  TSS  trace  number  (in  octal)  in  the  second  half 
of  the  first  word  of  the  trace  Itself.  Also,  the  remaining  two  to  six 
words  of  the  trace  Itself  are  printed.  Printed  next  is  the  title  of  the 
TPE  trace  (a  20  character  field).  Also  printed  is  the  trace  time  con¬ 
verted  to  seconds  (trace  time  is  microseconds  originally)  minus  the 
initialization  time,  and  the  trace  time  of  day  in  a  24-hour  day.  Any 
BCD  representations  in  the  various  traces  will  be  displayed  in  readable 
format  also.  This  report  is  written  to  report  code  08.  An  example 
formatted  du^  is  shown  in  figure  12-20. 

12.5.3  Summary  Report.  There  Is  a  small  summary  report  written  to  report 
code  09  which  lists  a  count  of  all  the  traces  found  and  the  times  (minus 
the  initialization  time)  in  seconds  of  the  first  four  traces  of  each 
trace  type,  (also  shown  in  figure  12-20). 


LOWLOAD 

SELECT  B29IDPXO/OBJECT/TPEDUMP 
EXECUTE  DUMP 

MSG 2  1, PLEASE  ENTER  "U"  IF  TAPE 

MSG2  1 .ERRORS  OCCUR 

LIMITS  10.26K.-2K.30K 
FFILE  P* ,LGU/ (06 ,08 ,09,23 ,24 ,25,29  ,42) 

FFILE  10,NSTDLB,NOSRLS,BUFSIZ/4094,FIXLNG/4094,ERRXIT/KILLFM 
TAPE  10 ,X1D , , ,  .NO-RING 

DATA  I* 

MAXOUT 

40000 

$  ENDJOB 


Figure  12-19.  JCL  For  TPE  Formatted  Dump 
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Figure  12-20.  TPE  Formatted  Dump  (Part  1  of  2) 
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SECTION  13.  EXTENDED  USE  OF  GMC 

13.1  Introduction 

Throughout  this  document  the  Generalized  Monitor  Collector  (GMC)  has  been 
described  as  a  trace  based  performance  evaluation  tool  used  to  evaluate 
the  performance  of  certain  preselected  components  of  the  H6000  computer 
system.  The  collectors  are  all  prewritten,  as  are  the  data  reduction 
programs  and  report  formats.  The  user  of  the  GMC  has  had  no  clearly 
defined  way  of  choosing  what  data  is  being  collected  or  how  to  expand 
the  monitoring  to  other  portions  of  system  activity. 

In  this  section,  an  attempt  will  be  made  to  describe  the  procedure  that 
must  be  followed  if  a  user  wants  to  develop  his  own  monitor.  The  design 
of  GMC  provides  the  user  with  a  relatively  simple  method  of  creating 
additional  monitors.  As  used  in  this  section,  the  word  monitors  does 
not  necessarily  mean  a  performance  monitor  but  rather  it  is  being  used 
in  the  broader  sense  of  a  tool  used  to  check  on  the  operation  of  a 
given  program  or  machine  component. 

13.2  Monitor  Structure 

Every  monitor  within  the  GMC  is  comprised  of  an  initialization  section 
and  a  data  collection  subroutine.  The  Initialization  section  is  used 
to  insure  that  the  correct  traces  are  active,  all  needed  subroutines  are 
present  and,  finally,  to  absolutize  necessary  code  in  the  data  collection 
subroutine.  The  data  collection  subroutine  is  used  to  process  the 
occurrence  of  a  given  H6000  trace,  gather  whatever  data  is  desired  and 
request  the  QIC  Executive  to  buffer  the  collected  data  to  tape,  for  later 
processing. 

13.2.1  Initialization  Section.  Prior  to  coding  this  section,  the  user 
must  decide  what  traces  he  desires  to  capture  and  must  select  a  monitor 
number.  The  monitor  numbers  can  range  from  the  letter  A  through  letter 
F  (Monitor  nuidaers  10-15).  The  H6000  traces  are  described  in  the  H6000 
System  Tables  Manual  (#DD14A) .  For  purposes  of  this  discussion,  it  is 
assumed  that  monitor  #C  has  been  selected  and  it  is  desired  to  capture 
trace  OCTAL  27.  Figure  13-1  shows  the  skeleton  format  required  for  the 
Initialization  section.  By  following  this  format,  and  looking  at  the 
initialization  sections  of  the  other  GMC  Monitors,  the  user  should  have 
no  problem  in  writing  this  portion  of  the  code. 

13.2.2  Monitor  Subroutine.  The  monitor  subroutine  is  a  master  mode 
program  that  collects  all  required  data  upon  execution  of  the  desired 
trace,  and  requests  the  GMC  executive  to  buffer  that  data  to  tape. 

Figure  13-2  provides  a  skeleton  for  a  monitor  subroutine. 

In  the  section  where  the  data  is  captured ,  if  the  user  performs  the 
following  two  statements,  every  record  collected  will  be  time  stamped. 

The  data  reduction  program  can  then  easily  convert  this  time  stamp 
into  a  wall  clock  time.  The  two  instructions  are: 
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SYMREF 


(Any  variables  or  locations  in  Monitor  routine  that 
need  to  be  absolutized  because  of  register 
mod  if  icat  ion) 


LDA 

ONOFF+#,$ 

#  ■  Monitor  number  (12) 

TZE 

USEROF, $ 

Monitor  is  off 

LDA 

■#,DL 

#  »  decimal  equivalent  of  trace  number 
(23)  (OCTAL  27) 

SZN 

CVECTR+# , $ 

#  -  decimal  equivalent  of  trace  number 
(23)  (OCTAL  27) 

TZE 

SUBERR, $ 

Monitor  routine  missing  from  R* 

LDAQ 

.CRTCT 

ANAQ 

USERTC, $ 

test  for  required  traces  being  on 

TNZ 

TRCERR , $ 

required  trace  was  off 

AOS 

ONOFF+# , $ 

#  ■  monitor  number  (12) 

ASX5 

• 

• 

XXX, $ 

absolutize  code  in  the  monitor 
subroutine,  if  required 

SZN 

.CRMBA 

Is  extended  memory  on? 

TNZ 

USEREN, $ 

Transfer  means  yes 

LDA 

EXTOFF, $ 

ANSA 

XXX, $ 

modify  ary  necesvi:-/  instructions 

• 

• 

because  extended  memory  is  off 

TRA 

• 

• 

USEREN, $ 

USEROF  STZ  CVECTR+# , $  #  -  decimal  equivalent  of  trace  number  (23) 

(repeat  for  each  trace  to  be  captured) 

TRA  USEREN,$ 

USERTC  OCT  (12  Octal  digits)  set  appropriate  bit 

OCT  (12  Octal  digits)  to  match  the  trace  #'s 

being  collected 

USEREN  NULL 


Figure  13-1,  New  Initialization  Section 


LBL 

T#C, TIC 

I  -  OCTAL  equivalent  of  trace 
number  (27) 

LODM 

EIGHT 

. G3MAC 

.ENTRY 

XSA2, , ,T#C, PRG 

1  »  OCTAL  equivalent  of  trace 
number  (27) 

SYMDEF 

T#,T#C, 

#  *  OCTAL  equivalent  of  trace 
number  (27) 

In  addition,  any  other  locations 
referenced  by  the  initialization  code 

SYMREF 

BUFCTL.SVRQ.SVRA 

SVRQ  contains  the  Q  register  from 
the  trace.  SVRA  contains  the  A 
register  from  the  trace. 

INHIB 

ON 

TRA 

WRAP,$ 

vrapup  code  for  when  monitor  is 
terminated 

T# 

NULL 

1  -  OCTAL  equivalent  of  trace 

TIC 

NULL 

number  (27) 

(Code  to  capture  any  data 

desired.  Data  is  written  to  a  user 

def ined 

buffer  area.  Code  is  in  Master  Mode). 

LDX3 

-#,DU 

number  of  words  of  data  generated 
(including  time  stamp  if  used) 

STX3 

TOPBUF, $ 

EAX3 

1,3 

count  the  header  word 

EAX2 

TOPBUF, 5 

TSXl 

BUFCTL.5 

Tell  executive  to  buffer  data 

TRA 

GOOD, $ 

data  written  to  buffer 

TRA 

LOST ,  $ 

internal  buffers  were  full,  data  is 
lost 

GOOD 

data  has  been  buffered. 

Perform 

any  needed  housekeeping  before  returning  to  system 

TRA 

0,0 

WRAP 

monitor 

Is  terminating. 

Perform  any  required  housekeeping  and 

write  a 

final  record,  if 

desired 

TRA 

0,0 

TOPBUFEZERO 

0,# 

|  -  decimal  ssHuivalent  of  trace 

TIME 

BSS  1 

number  (23) 

BUF 

BSS  # 

#  “  number  of  words  of  data 

LOST  data  vaa  not  able  to  be  placed  in  buffer. 
Perform  any  needed  housekeeping  and 
return  to  system 
TRA  0,0 


Figure  13-2.  Monitor  Subroutine 
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RSCR  32 

STQ  TIME,  $  store  the  time.  This  word  should  be  counted  in 

the  total  number  of  words  of  data  collected. 

13.3  User  Generated  Trace 

If  a  user  has  the  capability  of  modifying  program  code,  either  directly 
in  source,  or  through  patching,  and  can  execute  in  master  mode,  he  can 
create  his  own  system  traces  anywhere  within  a  program.  Thus,  in  effect, 
he  can  use  the  GMC  system  to  monitor  the  execution  of  any  program  of  his 
choice.  If  the  new  monitor  is  being  executed  in  conjunction  with  the 
CAM,  CPU,  GRTS,  or  MSM  monitors,  the  user  must  be  sure  not  to  use  the 
trace  numbers  14,  70,  62,  73  or  76  octal,  created  by  these  GMC  monitors. 
Figure  13-3  provides  the  skeleton  code  for  creating  system  traces.  It 
should  be  noted  that  the  time  returned  from  executing  the  trace  code  in 
figure  13-3  is  not  the  same  time  as  obtained  from  the  RSCR  instruction 
described  in  13.2.2. 

It  is  also  possible  to  directly  transfer  into  the  GMC  program.  However, 
this  procedure  is  too  complicated  to  be  explained  in  this  document.  If 
the  user  is  interested  in  using  this  procedure,  he  should  examine  the 
manner  in  which  the  CPU  monitor  interfaces  with  the  system.  Special 
attention  should  be  paid  to  files  CPU. PAT,  CPU. REMO,  and  CPUDOIT.  When 
using  this  method  the  user  will  need  to  alter  his  monitor  routine  with 
the  addition  of  three  instructions.  These  instructions  check  whether 
the  user  generated  trace,  or  a  system  trace  is  being  processed.  System 
traces  will  be  Ignored.  In  figure  13-2,  following  label  T#C  the  follow¬ 
ing  three  instructions  should  be  added: 

LXL2  SVRA,5  get  the  trace  number 

CMPX2  -05757XX  where  XX  *  octal  trace  number 

TNZ  0,0  system  trace  ignore 

13.4  Data  Reduction 

In  order  to  analyze  the  tape  generated  by  the  new  monitor,  a  data 
reduction  program  must  be  coded.  This  step  will  prove  to  be  the 
most  difficult  and  time  consuming  step  to  execute.  In  order  to 
proceed  with  the  coding  of  a  data  reduction  program  the  user  should 
examine  the  source  code  of  the  already  existing  CMC  monitors.  Much 
of  the  code  needed  to  process  the  GMC  tape  is  already  written  and  can 
be  used  with  minimum  modification  by  the  user.  For  purposes  of  this 
document,  the  CM  data  reduction  program  will  be  used  as  an  example. 

The  remaining  description  assumes  that  the  user  has  a  source  listing  of 
CM  available  to  him. 

13.4.1  Subroutine  INIT2.  This  subroutine  performs  many  functions  within 
the  program  but  the  areas  of  interest  at  present  begin  at  the  first  lines 
of  executable  code.  At  this  point  in  the  code  the  initial  data  record  on 
the  tape  is  read,  the  initial  start  time  of  data  collection  is  determined 
and  the  system  configuration  is  determined.  This  initial  record  was 
written  to  tape  by  the  GMC  executive  and  must  be  processed  before  the 
user  can  begin  to  reduce  the  records  generated  by  his  monitor.  Much  of 
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XED  .CRTRC 

TRA  DONE,$  code  to  be  executed  when  trace 

is  completed  or  if  trace  is  off 

Code  to  set  up  A&Q 
registers 


ORA 


TRA 

or 

TRA 

DONE  NULL 


-05757XX,DL  where  XX  is  the  octal  trace  number 

desired  to  be  used.  The  57S7  insures 
that  the  CMC  will  be  able  to  distinguish 
this  user  generated  trace  from  a  system 
trace  of  the  same  nutri>er. 

-1,0  (Time  of  Day  in  Q  register) 

1,0  (A&Q  registers  not  changed) 
return  code  or  trace  off  code 


Figure  13-3.  Creation  of  User  Trace 


the  data  In  this  record  can  be  ignored  by  the  user,  if  he  is  not 
interested  in  the  system  configuration.  However,  execution  of  this 
code  exactly  as  written  will  insure  proper  execution.  The  meaning 
of  each  word  within  this  initalization  record  can  be  found  in  section 
5  of  this  document.  All  code  down  to  the  beginning  of  the  1000  do  loop 
should  be  executed.  The  key  points  that  should  be  noted  are  as  follows: 

o  DATPTR  -  This  word  will  now  point  to  the  header  word  of  the 
first  monitor  trace  on  the  tape. 

o  INDATA  -  Array  which  contains  a  complete  CMC  record,  i.e.  , 

4090  words. 

o  HOUR  -  Starting  hour  of  the  data  collection 

o  MINUTE  -  Starting  minute  of  data  collection 

o  PMHOUR  -  Current  hour 

o  PMINUT  -  Current  minute 

o  PMSECD  -  Current  second 

o  PTIME  -  Current  RSCR  time  stamp 

o  ORGTIM  and  STRTIM  -  Initial  RSCR  time  stamp 

o  OLDT.BEGINT  -  Variables  needed  for  later  time  calculations 

upon  leaving  subroutine  INITZ  the  user  can  begin  to  process  trace  data. 

The  variable  DATPTR  points  to  the  header  record  of  a  monitor  trace  with 
bits  30-35  of  this  word  indicating  the  trace  number  of  the  data  following. 

13.4.2  Subroutine  NXTRECRD .  After  having  processed  a  monitor  trace  or 
determining  that  this  monitor  trace  is  of  no  Interest,  a  call  to 
subroutine  NXTRECRD  will  advance  DATPTR  to  the  next  monitor  record. 

13.4.3  Subroutine  RLOVER.  If  the  user  is  interested  in  maintaining  a 
wall  clock  time  for  each  monitor  trace  executed,  the  following  code 
should  be  executed: 

PTIME  -  AND  ( INDATA ( DATPTR +X) ,MAKPLS)  Where  X  is  the  offset  for 
the  RSCR  time  word  in  the  trace. 

STARTM  -  ORGTIM 

SBEG  -  BEGINT 

CALL  RLOVER 

TIMES  -  TIMES/ 100000  SBEG 
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At  this  point,  TIMES  will  contain  the  total  run  time  accumulated  thus  far 
in  1/10  seconds.  MAKPLS  is  a  variable  that  is  defined  within  the  CM 
program. 


13.4.4  Subroutine  TIMlDAY.  In  order  to  convert  the  variable  TIMES  into 
a  wall  clock  time,  the  following  code  should  be  executed: 

CALL  TIMEDY2 
PMHOUR  -  PHOUR 
PM I NUT  -  FMINUT 
PMSECD  -  FSECOND 

PMHOUR,  PMINUT  and  PMSECD  will  now  contain  the  current  wall  clock  time. 

13.4.5  Subroutine  MAIN.  The  CMC  executive  will  create  several  addi¬ 
tional  trace  records  that  must  be  checked  for  by  the  user  and  must  be 
processed  correctly.  The  first  is  a  lost  data  record  which  Indicates 
that  one  or  more  buffer  records  were  lost  and  not  written  to  tape. 
Another  record  is  a  monitor  termination  record  and  indicates  that  data 
collection  has  been  completed.  All  these  record  types  are  processed  in 
the  MAIN  subroutine  and  the  user  should  reference  this  code  for  proper 
handling  of  these  record  types. 

13.4.6  Other  Routines.  The  CM  data  reduction  program  also  contains 
routines  for  creating  histograms  and  plots.  However,  for  purposes  of 
this  document,  these  routines  are  too  complicated  to  explain.  This 
chapter  should  allow  a  user  to  be  able  to  write  his  own  monitor  and 
begin  the  process  of  writing  a  data  reduction  program.  The  user 
should  note  that  two  subroutines  required  for  all  data  reduction 
programs  are  ALIGN  and  EVENUP. 

13.5  Utility  Tape  Dump 

If  the  user  is  interested  in  quickly  being  able  to  see  the  data  that 
was  collected  he  can  run  a  standard  Utility  Tape  Dump.  The  following 
JCL  should  be  used: 


UTILITY 

LIMITS 

FFILE 

FUTIL 

TAPE 

ENDJOB 


10,40K, ,30K 

01 ,NSTDLB .NOSRLS , BUFSIZ/4094 .FIXLNG/4094 
01,,RWD/01/,DUMP/XR/ 

where  X  -  number  of  records  to  be  dumped 
01 ,X1D, ,Tape# 
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SECTION  14.  CONDUCTING  A  SITE  COMPUTER  PERFORMANCE  EVALUATION  USING 
THE  CMC 


14.1  Introduction 


A  general  plan  for  using  the  CMC  System  and  document  when  conducting  a 
performance  evaluation  of  a  Honeywell  6000  computer  system  is  presented  io 
this  section.  Detailed  analysis  procedures  that  guide  the  analyst  io  applying 
specific  techniques  to  analyze  system  performance  are  introduced.  The  primary 
purpose  is  to  aid  the  analyst  in  his  use  of  the  CMC  reports.  This  section 
will  indicate  which  reports  the  analyst  should  reference,  what  data  he  should 
extract  from  those  reports,  and  some  guidance  as  to  what  the  reports  are 
indicating.  In  some  cases,  possible  corrective  ("tuning")  recommendations 
will  be  made,  but  tuning  guidance  is  not  the  primary  purpose  behind  this 
section.  If  a  tuning  study  should  be  made,  the  user  must  rely  on  his  on 
personnel  skills  and  the  tools  of  GMF  to  perform  such  a  study. 

14.2  General  Definitions 

14.2.1  Computer  Performance  Evaluation  (CPE).  Computer  performance 
evaluation  is  a  generic  term  applied  to  many  techniques  for  'determining  the 
performance  characteristics  of  both  a  computer  system  and  its  associated  site 
processing  activities.  The  performance  characteristics  may  be  compared  to 
many  criteria,  including:  (l)  standards  of  economic  operation,  (2)  technical 
norms,  dr  (3)  measures  of  service  provided. 

14.2.2  Computer  System  Performance  Variables.  The  performance  of  a  computer 
system  is  influenced  by  nearly  every  facet  of  the  data  processing  function. 

The  following  examples  define  the  scope  of  the  computer  performance  function. 

14.2.2.1  System  Design.  Computer  application  system  design  and  development 
can  be  the  starting  point  of  performance  degradation.  Errors  in  original 
design  with  respect  to  I/O  media  selection,  file  structures,  frequency  of  run , 
etc.,  may  result  io  less  than  optimal  performance  for  as  long  as  an 
application  is  in  existance. 

14.2.2.2  Programming.  A  computer  programmer's  proficiency  and  the 
availability  of  program  optimization  tools,  for  example,  will  influence 
program  design  aod  coding,  and  affect  system  performance. 

14.2.2.3  Hardware  Configuration.  Specific  components  of  a  computer  system 
may  be  mismatched  to  the  system  as  a  whole,  causing  major  subsystems  (or  the 
entire  configuration)  to  operate  at  a  reduced  performance  level.  Even  if  the 
performance  capabilities  of  the  individual  subsystems  are  reasonably 
well-matched,  the  system  may  be  poorly  configured  for  the  site's  workload, 
resulting  in  poor  performance. 


14.2.2.4  System  Software.  System  software  is  considered  to  be  those  programs 
supplied  by  the  mainframe  vendor.  This  software  may  be  inappropriately 
parameterized  to  fit  the  site  workload,  or  may  be  a  source  of  high  overhead  or 
bottlenecks  to  efficient  workload  processing. 

14.2.2.5  Operations.  Operations  consists  of  functions  such  as  the  scheduling 
of  the  workload,  providing  job  assembly  (and  library)  services,  and  operating 
the  system  through  the  console.  All  of  these  functions  are  vital  to  the 
proper  operation  of  the  system.  Mistakes,  insufficient  training,  poor 
documentation,  and  a  variety  of  other  factors  may  contribute  to  operational 
problems  which  substantially  decrease  system  performance. 

14.2.2.6  Communications  Hardware  and  Software.  A  communications  network,  its 
interface  to  a  central  system,  and  the  software  used  to  control  the  on-line 
applications,  may  have  a  significant  impact  on  the  system's  overall 
performance . 

14.2.2.7  Computer  System  Performance  Tuning.  The  process  of  analyzing  and 
appropriately  adjusting  computer  system  performance  variables  is  known  as 
computer  system  performance  tuning.  After  becoming  proficient  in  the  use  of 
GMF,  the  user  should  be  able  to  conduct  his  own  tuning  study. 

14.2.2.8  Turnaround  Time.  This  is  the  total  elapsed  time  taken  by  a  job  (or 
set  of  jobs)  submitted  to  a  WWMCCS  site  for  batch  processing.  Total  batch 
turnaround  time  is  comprised  of  computer  system  processing  and  physical  input 
and  output  handling  in  the  machine  room,  both  before  and  after  system 
processing.  A  job's  total  turnaround  time  therefore  includes  all  processing 
and  waiting  points  through  which  the  job  must  pass  from  submission  until 
return  to  a  user.  The  GMC  measures  only  a  batch  job's  computer  processing 
turnaround  time.  The  other  measure  of  total  turnaround  time  (input/output 
handling)  are  important  and  can  be  a  bottleneck  to  total  turnaround  time. 

14.2.2.9  CPE  User  Objectives.  The  definitions  associated  with  any  or  all  of 
the  above  data  processing  functions  can  be  considered  variables  that  affect 
computer  system  performance.  The  GMC  reports  should  be  used  to  determine 
which  of  the  above  functions  need  further  investigation. 

14.3  Solutions  to  Performance  Problems 

Particular  resource  bottlenecks  may  be  confirmed  as  elongating  turnaround  or 
response  time.  Several  solutions  can  usually  be  applied  to  remove  a 
particular  bottleneck.  In  general,  four  kinds  of  solutions  exist  to  remove 
identified  bottlenecks. 

14.3.1  Scheduling  Solutions.  These  solutions  change  the  way  Chat  either 
batch  or  TSS  workloads  are  scheduled  for  processing.  They  shift  particular 
workloads  to  more  evenly  distribute  system  resources  across  the  workload. 

14.3.2  Parameter  Solutions.  These  changes  involve  adjustments  to  system  or 
subsystem  functions.  Examples  include:  (1)  changes  to  Che 
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parameters  of  the  GCOS  Dispatcher  or  (2)  a  change  in  the  placement  of  GCOS 
libraries.  A  solution  may  also  include  specific  changes  to  GCOS  code,  made 
through  authorized  software  patch  procedures. 

14.3.3  Programming  Solutions.  These  changes  can  involve  modification  of  one 
or  more  processing  jobs  running  in  the  system.  Recommendations  may  be  made  to 
speed  application  of  jobs  by  changing  particular  file  locations  discovered  as 
delaying  the  job. 

14.3.4  Sizing  Solutions.  These  types  of  system  changes  involve  an  increase, 
decrease,  or  realignment  in  the  system's  hardware  configuration. 

14.4  Structure  of  the  Analysis  Process 

The  analysis  process  in  figure  14-1  is  a  flow  chart  that  should  be  referenced 
during  a  performance  study.  The  analysis  process  is  comprised  of  two  phases: 
(1)  a  Problem  Definition  Phase  and  (2)  a  Problem  Analysis  Phase.  The 
activities  of  the  Problem  Definition  Phase  are  directed  toward  determining 
whether  a  batch  turnaround  time  or  TSS  response  time  problem  actually  exists. 
The  activities  of  the  Problem  Analysis  Phase  are  directed  toward  revealing 
causes  of  the  identified  curnarout.d  time  or  response  time  problem. 

14.4.1  Starting  The  Process.  The  evaluation  process  may  begin  in  one  of 
three  ways:  (1)  by  direct  request,  (2)  by  an  internal  review  of  site-selected 
service  elongation  metrics,  (3)  by  user  requests. 

14.4.1.1  Direct  Request.  The  request  may  by  initiated  by  WWMCCS  management, 
directing  a  facility  to  perform  an  analysis  and  tuning  effort.  Many  reasons 
could  cause  management  to  request  a  CPE  study.  Examples  include:  (1)  desire 
to  extend  the  life  of  a  system,  (2)  pressure  applied  from  users  through  higher 
authority,  (3)  awareness  of  the  potential  for  performance  gain  after  an 
evaluation,  and  (4)  a  desire  for  management  to  evaluate  cost  reduction 
programs. 

14.4.1.2  Internal  Review.  The  decision  to  initiate  a  study  may  result  from 
the  output  of  a  performance  exception  reporting  system  or  from  the  desire,  to 
conduct  a  periodic  review  of  site  operations. 

14.4.1.3  User  Requests.  Users  of  site  services  may  request  an  evaluation. 
Complaints  of  unacceptable  batch  turnaround  time  or  TSS  response  time  can 
initiate  a  search  for  their  causes.  Unfavorable  comparisons  with  service 
rates  provided  at  other  installations  can  point  out  the  need  for  a  study  to 
determine  if  service  can  be  improved. 

14.4.2  Problem  Definition  Phase.  The  Problem  Definition  Phase  (see  figure 
14-1,  part  H  is  comprised  of  four  activities:  (1)  define  and  verify  the 
problem,  (2)  gain  understanding  of  facility  environment,  (3)  understand 
installation  service  objectives  and  priorities,  and  (4)  specify  current 
evaluation  objectives.  Some  of  these  activities  are  initiated  as  evaluation 
begins.  Others  are  maintained  as  on-going  activities.  The  activities  of  the 
Problem  Definition  Phase  are  introduced  below. 
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Figure  14-1.  Flowchart  Of  Evaluation /Tuning  Process  (Part  1  of  2) 


14.4.2-1  Define  and  Verify  the  Problem.  For  whatever  reason  the  evaluation 
was  initiated,  a  starting  point  or  premise  must  oe  established.  The  problem 
must  be  described  as  well  as  it  can  at  this  point,  even  if  at  a  very  general 
level,  "batch  turnaround  time  is  poor"  or  "T SS  response  time  must  be 
improved"  are  valid  statements  of  problems  at  this  time.  Site  management  must 
then  verify  that  this  is  the  problem  they  wish  to  pursue.  The  facility  staff 
and  users  should  verify  that,  in  fact,  this  problem  does  exist  and  that  they 
view  it  as  a  problem  of  importance.  Note  that  a  specific  evaluation  objective 
is  not  yet  defined;  only  the  basic  problem  statement  is  verified. 

14.4.2.2  Gain  Understanding  of  Facility  Environment.  This  second  step  helps 
the  CPE  analyst  relate  the  system  environment  to  the  problem  statement.  This 
activity  may  be  time-consuming  if  the  analyst  has  little  personal  experience 
with  the  facility  and  the  system.  Information  collected  during  this  activity 
will  help  determine  the  reason  for  the  problem's  importance;  it  may  explain  a 
reason  for  the  problem's  existence  and  help  rank  one  problem  against  another. 
The  activity  forces  an  analyst  to  view  the  entire  facility;  this  is  important 
since  many  performance  problems  are  caused  by  combinations  of  factors.  The 
activity  assists  the  analyst  in  understanding  how  to  narrow,  refine,  modify, 
and  improve  the  problem's  definition  in  order  to  attempt  a  valid  solution. 

Each  area  described  in  the  following  paragraphs  snould  be  examined.  It  may 
help  the  analyst  to  examine  them  in  the  order  they  are  given  below. 

14.4.2.2.1  Hardware  Configuration.  The  exact  system  configuration  should  be 
determined  and  a  diagram  of  the  overall  structure  of  the  system  should  be 
created.  Collection  of  reliability  statistics  on  major  configuration 
components  and  a  history  of  hardware  changes  to  the  configuration  should  be 
done . 


14.4.2.2.2  Software  Configuration  and  Development  Practices.  The  exact 
operating  system  configuration  snould  be  determined.  Any  local  changes  made 
to  the  system  and  any  specialized  major  subsystems  that  are  running  should  be 
documented.  Document  software  monitors  and  other  CPE  measurement  techniques 
used.  Determine  program  optimization  techniques  used  and  note  standards 
imposed  on  operations  anc  programming  staffs. 

14.4.2.2.3  Existing  CPE  Practices.  Responsibility  for  computer  performance 
evaluation  at  the  site  must  be  determined.  Identify  sources  of  CPE  data  that 
are  employed  and  determine  how  the  data  are  used  to  evaluate  system 
performance.  Determine  if  personnel  in  all  site  functional  areas  (e.g., 
programming  and  operations)  can  relate  to  the  performance  data.  Research  how 
previous  CPE  studies  conducted  at  the  site  in  the  past  have  been  documented. 
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14.4.2.2.4  Site  Workload  Characteristics.  The  existing  workload  uses  of 
system  resources  should  be  scribed.  Identify  patterns  of  resource  use  by 
selected  jobs.  Obvious  bottlenecks  to  the  handling  of  jobs  witnin  the 
installation  should  be  determined.  The  resource  monitor.,  the  RMC  portion  of 
GMF,  should  prove  very  useful  during  this  phase. 

14.4.2.2.5  System  Users.  The  workload  analysis  should  be  expanded  by 
investigating  the  practices  of  the  major  users  in  the  installation.  Determine 
how  special  priorities  are  assigned  to  tnese  users  ana  whether  the  users  can 
directly  control  system  resources.  Note  cnargeback  schemes  used  ?if  any)  to 
level  the  workload  across  the  operating  aay  and  night.  Evaluate  the  levels  of 
user  satisfaction  (or  dissatisfaction)  exhibited. 

14.4.2.2.6  Operations  Practices.  The  operating  shift  schedule  for  the  site 
should  be  examined.  Analyze  pre-scheduled  and  nonproduction  time  and 
unscheduled  nonproduction  time.  Evaluate  training  proviaed  for  operators  ana 
systems  programmers.  Study  site  library  maintenance  procedures.  Examine  the 
proauction  control  points  established  by  operations.  Observe  h<;w  formalized 
logs  are  maintained  to  track  work  as  it  passes  through  the  installation. 

14.4.2.2.7  Batch  Job  Scheduling.  Observe  how  batch  work  is  accepted  for 
processing  at  the  site.  Study  the  techniques  used  to  schedule  the  batch 
workload  that  are  either  automated  or  are  manually  implementea. 

14.4.2.2.8  Site  and  Computer  Facility  Organization.  Study  the  organization 
structure  and  reporting  authority  at  the  site.  This  includes  the  organization 
of  the  site  itself.  Determine  the  extent  to  which  system  sizing  activities 
are  organizationally  separated  from  operations  and  applications  systems 
development . 

14.4.2-3  Understand  Installation  Service  Objectives  and  Priorities.  This 
third  step  determines  site  processing  objectives  and  priorities  to  be  applied 
to  decisions  made  during  both  the  Problem  Definition  and  Problem  Analysis 
Phases . 

14.4.2.3.1  Installation  Service  Objectives.  To  be  effective,  a  CPE  effort 
must  consider  the  hardware,  software,  personnel,  and  service  objectives  of  the 
computer  installation  being  analyzed.  Although  the  first  three  areas  are 
readily  identifiable,  the  site's  service  objectives  are  often  misunderstood. 

An  installation’s  objectives  can  emphasize  production  or  availability,  or  a 
mixture  of  both.  A  mixture  is  generally  dominated  by  either  a  production  or 
availability  objective.  A  production  objective  attempts  to  take  full 
advantage  of  the  capabilities  of  the  system  in  terms  of  throughput.  With  a 
customer-oriented  availability  objective,  however,  the  interests  of  the  users 
take  priority  over  the  most  efficient  use  of  system  resources.  In  either 
case,  the  computer  installation's  management  objective  is  return  on 
investment.  For  the  production  objective,  the  most  important  investment 


is  the  coaputer;  for  the  availability  objective,  the  most  important  investment 
is  the  people  or  system  using  the  computer.  The  difference  between  these  two 
objectives  is  reflected  in  how  the  performance  parameters  are  evaluated. 

14.4.2.3.1.1  Production  Objective.  Traditional  data  processing  is 
production-oriented.  The  computer  installation  is  viewed  as  a  large 
investment  for  capacity  to  do  routine  work.  Much  of  that  capacity  depends  on 
a  high  degree  of  simultaneous  use  of  many  system  components.  Management's 
production  objective  is  to  use  as  many  of  the  components  as  much  of  the  time 
as  possible  by  scheduling  compatible  jobs.  Under  these  conditions,  low  batch 
turnaround  and  TSS  response  times  are  secondary  to  high  machine  utilization. 
Management's  success  is  generally  defined  in  terms  of  a  relatively  high  number 
of  jobs  contending  for  computer  resources  (a  high  multiprogramming  level), 
high  central  processor  unit  (CPU)  activity,  nearly  full  memory  utilization, 
and  highly  active  channels.  Schedule -driven  processing  uses  internal  and 
external  priority  allocations  to  sustain  efficiency.  Programs  must  be  written 
to  share  available  resources.  This  can  be  done  with  program  segmentation 
techniques,  use  of  a  minimum  number  of  devices,  the  indirect  use  of 
input/output  through  spooling,  and  adherence  to  rigid  standards  —  all  at  the 
expense  of  the  individual  job.  Data  must  be  so  distributed  that  device 
activity  is  economically  justified  with  the  attainment  of  a  low  system  wait, 
low  unit  cost,  and  high  simultaneity. 

14.4.2.3.1.2  Availability  Objective.  Service-oriented  systems  are  more 
concerned  with  return  on  investment  for  users  (managers,  scientists,  or 
programmers)  than  with  the  computer  itself.  Low  TSS  response  and  batch 
turnaround  times  are  critical.  Their  increase  delays  user  operations  on  such 
applications  as  on-line  command  and  control  systems,  real-time  update  systems, 
scientific  support  services,  and  program  development  systems.  Demand-driven 
processing  varies  in  activity  levels,  both  by  users  and  type  of  work.  Minimum 
emphasis  is  placed  on  scheduing.  The  system  must  therefore  have  available 
capacity  ready  to  respond  to  demand.  Such  a  system  must  have  utilization 
rates  well  below  the  100%  limit  in  order  to  accommodate  the  variations  in 
demand.  Success  is  measured  in  terms  of  user  satisfaction  and  little  emphasis 
is  placed  on  reporting  high  utilization  figures. 

14.4.2.3*1.3  Mixed  Objectives.  Usually  computer  installations  encounter  (1) 
demands  for  highly  responsive  services  and  (2)  pressure  from  management  for 
high  production  rates.  The  two  objectives  are  not  mutually  exclusive. 
Predominance  of  either  objective  can  be  identified  within  operational  time 
periods,  and  management  must  evaluate  whether  the  satisfaction  of  one 
objective  might  deleteriously  affect  the  satisfaction  of  another. 

Computer  performance  evaluation  can  serve  the  management  of  either  type  of 
computer  installation  and  can  also  serve  mixtures  that  might  have  different 
objectives,  depending  on  the  time  of  day  or  day  of  the  week.  However,  it  is 
important  that  managers,  auditors,  and  executives  recognize  the  implications 
of  the  different  objectives  when  they  compare  the  performance  of  one 
installation  to  another. 
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14.4.2.3*2  Installation  Priorities.  The  installation's  priorities  derive 
from  the  predominance  of  either  the  production  objective  or  the  availaoility 
objective  at  a  particular  site.  They  also,  by  implication,  determine  the 
sequence  in  which  system  tuning  solutions  are  applied. 

14.4.2.3.2.1  Service  Priorities.  A  site  may  feel  that  low  TSS  response  time 
is  more  desirable  than  low  batch  turnaround  time  for  a  certain  period  of  the 
operating  day.  The  analysis  procedures  presented  in  this  section  are  not 
generally  directed  toward  determining  which  of  the  two  is  "more  important". 
However,  the  sequence  of  examining  either  of  the  two  service  areas  may  be 
affected  by  this  priority. 

14.4.2.3.2.2  Evaluation/Tuning  Solution  Priorities.  Tuning  solutions  are 
presented  to  correct  system  bottleneck  conditions.  In  nearly  all  cases,  more 
than  one  solution  is  specified  to  correct  a  problem.  The  solutions  are 
generally  proposed  in  a  sequence  that  recommends  the  more  quickly  (or  easily) 
applied  solution  be  implemented  before  others.  Installation  requirements  may 
change  this  sequence. 

14.4.2.4  Specify  Current  Evaluation.  This  fourth  step  is  used  to  determine 
whether  the  originally  specified  problem  can  actually  be  investigated  with 
currently-available  procedures. 

14.4.2.4.1  Objective.  An  objective  is  a  stated  (i.e.,  documented)  goal  of  an 
analysis.  An  objective  must  be  stated  in  specific  and  quantified  terms.  The 
objective  statement  is  used  to  determine  when  a  particular  analysis  has  been 
completed.  Examples  of  well-stated  objectives  are:  (1)  "reduce  mean  response 
time  for  (stated)  non-trivial  TSS  commands  to  five  seconds"  and  (2)  "reduce 
the  mean  batch  turnaround  time  for  (stated)  jobs  to  1.5  hours."  A  well-stated 
objective  includes:  (1)  definition  of  the  workload  catagory,  (2)  a 
description  of  the  process  to  be  investigated,  and  (3)  a  service  metric 
value.  Examples  of  badly-stated  objectives  are  "reduce  TSS  response  time"  and 
"improve  turnaround  time."  Note  the  missing  components  of  these  objectives. 

14.4.2.4.2  Objective  Decision.  Determine  whether  the  objective  as  documented 
is  realistic,  attainable,  and  a  cost  effective  target. 

14.4.2.4.2.1  Attainable  Objectives.  Objectives  must  be  attainable.  It  might 
be  possible  to  reduce  a  program's  elapsed  time  to  certain  limits,  but  not  to  a 
desired  limit,  simply  because  of  the  quantity  of  I/O  and  computation  that 
occurs  within  the  program.  If  this  is  the  case,  re-evaluate  the  objective. 

14.4.2.4.2.2  Realistic  Objectives.  It  migWr  be  possible  to  reduce  a 
program's  elapsed  time  to  the  desired  amount.  However,  particular 

site  constraints  may  prevent  its  being  a  realistic  goal.  These  constraints 
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.■night  have  their  source  outside  of  the  tuning  effort,  but  directly  affect  the 
internal  performance  of  the  program.  These  might  include,  for  example,  the 
requirement  to  give  certain  other  jobs  higher  priority.  If  this  i»s  the  case, 
re-evaluate  the  objective. 

14 .4.2  .2 . 3  Cost-Effective  Objectives.  The  additional  effort,  cost,  and 

time  required  to  achieve  an  attainable  and  realistic  objective  mignt  not  be 
worth  it.  A  particular  increment  of  performance  improvement  might  simply  not 
be  cost  effective.  Determine  the  amount  of  improvement  likely  with  additional 
effort.  Decide  whether  the  effort  might  be  better  off  abandoned. 

14.4.2.4.3  Determine  if  Worth  Continuing.  The  final  part  of  step  four  is  to 
determine  whether  the  process  itself  is  worth  continuing.  There  may  be 
potential  performance  problems  of  greater  magnitude  or  immediate  importance 
that  may  have  been  uncovered  during  the  Problem  Definition  Phase.  Document 
the  decision  and  the  objective  and  obtain  management  approval  of  them. 

14.4.2.4.4  begin  Problem  Analysis.  Having  obtained  concurrence  from 
management,  begin  tne  second  naif  of  the  performance  evaluation  process  (see 
figure  14-1,  part  2):  the  Problem  Analysis  Phase.  Activities  of  this  phase 
involve  the  execution  of  the  various  GMC  monitors  and  the  analysis  of  their 
output . 

14.4.3  Problem  Analysis  Phase.  The  Problem  Analysis  Phase  (see  figure  14-1, 
part  2)  is  comprised  of  five  activities  briefly  described  below: 

14.4.3.1  Run  Appropriate  Analysis  Tool.  Analysis  requires  collection  of  data 
to  start  an  investigation.  The  various  GMC  monitors  have  been  developed  for 
this  purpose. 

14.4.3.2  Evaluate  System  Output.  The  output  from  the  various  GMC  monitors 
must  be  analyzed. 

14.4.3.3  Follow  Tuning  Procedures.  The  user  must  develop  his  own  skill  in 
developing  provide  specific  procedures  to  test  hypotheses  by  examining  the 
reports  produced  by  the  GMC  monitors.  Specific  system  tuning  steps  can  result 
from  the  tests. 

14.4.3.4  Evaluate  Need  to  Continue  the  Tuning.  This  decision  is  made  after 
the  relevant  recommendations  have  been  implemented.  If  the  current  objective 
(specified  in  the  last  activity  of  the  Problem  Definition  Phase)  has  not  been 
met,  the  user  analysis  can  define  areas  for  further  investigation. 
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14.5  Composition  of  a  Performance  Evaluation  Team 


While  this  section  has  been  developed  to  aid  WWMCCS  ADP  Managers  in  the 
application  of  various  computer  performance  evaluation  tools  and  techniques, 
the  actual  team  conducting  this  analysis  must  have  a  reasonable  education  and 
experience  level  on  the  H6000.  The  team  should  be  comprised  of  at  least  one 
individual  familiar  with  system  software  and  its  operation;  one  individual 
generally  familiar  with  system  hardware  (at  least  in  terms  of  functionality); 
one  individual  familiar  with  the  procedures  for  executing  jobs  on  the  H6000 
and  at  least  one  individual  (probably  a  manager)  who  is  familiar  with  the 
objectives  and  priorities  of  the  installation.  It  certainly  is  possible  that 
one  individual  may  be  able  to  handle  several  of  the  above  functions. 

14.6  System  Evaluation 


14.6.1  In troduction .  A  total  system  evaluation  should  be  performed  at  least 
once  a  year.  It  may  have  to  be  performed  more  often,  depending  upon  the 
results  of  daily  resource  statistics.  A  steady  increase  in  resource 
utilization  would  possible  imply  the  need  for  an  evaluation.  The  Resource 
Monitor  (RMON)  of  GMF  should  be  used  to  track  daily  resource  utilization. 

The  data  collected  for  the  detailed  system  evaluation  must  be  representative 
(i.e.,  typical)  of  the  data  that  would  be  collected  on  a  "normal"  day.  This 
requires  the  collection  of  data  over  several  time  periods.  The  suggested 
schedule  for  collecting  data  for  a  total  system  analysis  is  to  run  the  GMC 
monitors,  intermittently  for  two  weeks.  The  monitors  should  be  run  as  two 
separate  groups,  on  alternate  days.  Group  one  would  consist  of  the  Memory 
Utilization  Monitor  (MUM)  (possibly  the  Idle  Monitor  (IDLEM)),  CPU  Monitor 
(CPUM) ,  Cotmnun ica t ion s  Analysis  Monitor  (CAM),  and  the  GRTS  Monitor  (GRTM)-. 
Group  two  would  consist  of  the  Mass  Storage  Monitor  (MSM) ,  Channel  Monitor 
(CM),  and  possibly  the  Idle  Monitor  (IDLEM).  This  sequence  provides  a  good 
representative  sample  of  the  system  workoad.  To  limit  the  amount  of  data 
collected,  it  is  advisable  to  run  Group  Two  only  during  prime  time,  heavy 
usage  (4-6  hours  per  day).  It  may  also  be  desirable  to  run  the  combined  set 
of  monitors  at  least  once  per  week  during  the  two-week  monitoring  session. 

This  allows  the  analyst  to  get  a  complete,  unified  picture  of  the  entire 
performance  of  the  system.  It  must  be  realized  that  a  large  number  of  ta-pes 
can  be  generated  under  such  a  monitor  configuration.  Therefore,  data 
collection  should  be  limited  to  no  more  than  four  hours  (during  heavy  prime 
time  usage). 

14.6.2  Selecting  a  Representative  Value  From  GMC  Histogram  Reports.  Some 
test  procedures  require  an  analyst  to  pick  a  "Representative  Value"  to 
describe  a  frequency  distribution.  The  following  paragraph  gives  guidelines 
for  choosing  Representative  Values  based  on  the  type  of  distribution  observed. 

Figure  14-2  shows  a  hypothetical  "Total  Elapsed  Time  an  Activity  Was  in 
Memory"  report.  Variations  of  this  report  will  be  us^d  to  illustrate  types  of 
distributions.  This  chapter  will  reference  only  the  pictorial  part  of  the 
report.  All  other  parts  of  the  histogram  report  are  described  in  Chapter  6  of 
this  document. 

14.6.2.1  Syrsnetric  Distribution  Closely  Clustered  Around  a  Single  Point.  The 
"Representative  Value"  for  the  distribution  shown  in  Figure  14-2  is  easy  to 
select.  The  values  are  clustered  around  the  "Average":  17.6  tenths  of  a 
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second,  or  1.76  seconds.  The  shape  of  the  distribution  is  symmetric  —  about 
the  same  number  of  activities  hac  values  over  1.76  seconas  as  unaer  1.76 
seconds,  and  the  standara  deviation  is  small  when  compared  to  the  average. 

The  absence  of  a  second  line  unaer  the  "Entries  Total"  line  indicates  that  no 
activities  stayed  in  memory  longer  than  2.4  seconds.  When  a  distribution 
resembles  this  example,  use  the  "Average"  printea  at  the  bottom  as  the 
Representative  Value. 

14.6.2.2  Skewed  Distribution.  Figure  14-3  shows  another  distribution.  This 
distribution  is  "skewed"  (i.e.,  not  symmetric),  because  most  of  the 
activities  spent  around  0.1  to  0.7  seconds  in  memory,  while  some  spent  as 
much  as  four  or  five  seconds.  Care  should  be  taken  when  selecting  a 
"Representative  Value"  from  this  distribution.  If  tne  analyst  wants  to 
emphasize  the  "typical"  activity,  which  stayed  in  memory  0.3  seconds  or  less, 
he  could  select  the  "median"  (the  value  which  evenly  divides  the  activities 
in  the  distribution  —  half  spent  less  time  in  memory,  and  half  spent  greater 
time  in  memory).  In  figure  14-3,  the  median  is  about  0.29  seconds.  The 
median  can  be  estimated  from  these  reports  by  descending  down  the 
"Cumulative"  column  (not  displayed  in  the  figure)  until  the  value  first 
exceeds  50.  The  median  falls  within  the  time  range  of  this  row. 

14.6.2.3  Distribution  With  Outliers.  There  are  some  instances  when  the 
distribution  will  also  have  some  values  that  were  too  big  to  fit  in  the 
histogram.  This  condition  will  be  indicated  by  an  additional  output  line  at 
the  bottom  of  the  report.  .  This  line  will  indicate  the  number  of  occurrences 
that  were  outliers,  the  average  for  just  the  outliers,  and  the  average  for 
the  values  that  fit  into  the  report,  minus  the  outliers.  The  three  important 
factors  about  these  types  of  distributions  are:  (1)  the  amount  of  times  they 
occur;  (2)  the  percent  of  the  total  values  that  are  outliers;  (3)  the 
"in-range  average." 

If  the  percent  of  outliers  is  greater  than  10%,  the  analyst  should  use  the 
overall  average,  given  in  the  first  line  of  the  report,  for  any  comparisons. 
If  the  percentage  of  out-of-range  values  is  less  than  10%,  the  analyst  can 
use  the  "in-range  average"  value  for  his  comparisons  since  the  effect  of  the 
outliers  will  most  likely  be  minimal  on  the  total  system  performance. 

14.6.3  Memory  Evaluation.  The  first  step  in  a  memory  evaluation  is  to 
summarize  all  the  pertinent  information.  The  easiest  way  to  do  this  is  for 
the  user  to  create  a  table  similar  to  figure  14-4.  The  information  for  each 
column  is  collected  from  various  MUM  reports.  Once  the  chart  is  filled  out, 
the  analyst  can  then  ascertain  a  reasonable  idea  of  the  overall  memory  status 
of  the  system.  The  reports  required  to  collect  the  statistics  will  be 
discussed,  as  well  as  an  analysis  procedure. 
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Figure  14-3.  Sample  Skewed  Distribution 
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14.6.3.1  Obtaining  the  Data.  The  first  step  is  for  the  user  to  examine  the  j 

monitor  data  collection  reports  for  the  total  time  of  the  run.  Any  monitoring 
session  of  less  than  2  hours  in  duration  should  be  discarded.  The  Title  Page  ] 

will  indicate  the  overhead  generated  by  eacn  of  the  GMF  monitors  active  during 

the  data  collection  phase.  While  this  information  is  not  used  in  this 
analysis,  it  is  an  item  of  information  that  is  usually  requested.  Columns  1 
and  2  of  figure  14-4  can  be  obtained  directly  from  the  MUM  Title  Page.  Under 
the  System  Configuration  section  of  the  Title  Page,  the  amount  of  memory 
configured  on  the  system  will  appear.  This  figure  should  be  tentatively  noted 
under  column  5.  Following  this  figure,  the  Title  Page  will  list  the  amount  of 
memory  used  by  Hard  Core,  Core  Allocator,  SSA  Cache  and  if  any  memory  releases 
occurred  during  the  monitoring  session.  All  these  functions  have  the  effect 
of  reducing  the  available  user  memory.  These  values  should  be  summed  and 
tentatively  recorded  under  column  6. 

Following  the  above  information  are  several  lines  of  statistics  concerning  the 
processing  characteristics  of  the  system.  Columns  17  and  18  may  be  filled 
from  this  information.  When  determining  the  number  of  activities  processed 
per  hour,  the  analyst  has  two  figures  available.  The  analyst  may  choose  to 
record  the  total  number  of  activities  processed  per  hour  or  he  may  record  the 
number  of  (non-system  scheoular)  activities  processed  per  hour.  During  the 
course  of  the  day  many  system  schedular  activities  (activity  0  of  any  batch 
job)  are  processed.  These  activities  are  not  really  user  generated,  but 
rather  are  generated  from  the  system.  Therefore,  by  removing  these  activities 
from  the  total  activities  processed,  a  more  realistic  figure  will  be 
generated.  The  final  three  lines  of  the  title  page  can  be  used  to  provide  the 
data  for  columns  3  ana  7  on  the  chart.  Column  4  is  filled  from  Report  1, 
columns  8  and  9  from  Reports  11  and  12,  columns  10  and  11  from  Reports  16  and 
17,  column  12  from  Report  19,  column  13  from  Report  51,  column  14  from  Report 
37,  column  15  from  Report  50,  and  column  16  from  Report  36.  The  two  remaining 
columns  that  need  to  be  completed  are  columns  5  and  6.  The  System  Program 
Usage  of  Memory  Report  should  be  used  to  complete  column  6.  When  processing 
the  MUM  data  reduction  program,  the  user  should  seriously  consider  using  the 
MASTER  input  option.  This  will  provide  the  user  with  a  much  better  indication 
of  the  true  system  program  load.  In  order  to  complete  Column  6,  the  user 
should  record  the  total  value  appearing  under  the  "WEIGHTED  TTM"  column  of  the 
System  Program  Usage  of  Memory  Report.  This  value  should  then  be  added  to  the 
value  already  recorded  under  Column  6.  Finally  Column  5  can  be  determined  by 
subtracting  the  value  reported  in  Column  6  from  the  value  previously  reported 
in  Column  5* 

14.6.3.2  Evaluating  the  Data.  Figure  14-4  should  be  used  in  the  following 
manner  to  determine  if  memory  is  a  system  constraint. 

Step  1  -  If  Column  7  shows  a  surplus  of  memory  greater  than  15%  of  the 
total  available  memory  or  greater  than  two  times  the  value  reported  in  Column 
4,  the  the  implication  is  that  there  is  no  memory  constraint  on  the  system. 
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If  Column  7  shows  a  surplus  of  memory,  but  does  not  exceed  the  aforementioned 
limits,  the  implication  is  that  the  current  system  has  sufficient  memory,  but 
that  the  system  is  approaching  memory  saturation.  If  Colulmn  7  shows  a 
shortfall  of  memory,  and  the  value  is  greater  than  15S  of  the  total  available 
memory  or  greater  than  two  times  the  value  reported  in  column  4,  then  the 
implication  is  that  memory  is  a  constraint  on  this  system.  Finally,  if  Column 
7  shows  a  shortfall  of  memory,  but  does  not  exceed  the  aforementioned  limits, 
the  implication  is  that  the  system  has  reached  memory  saturation,  but  is  still 
able  to  process  the  current  workload. 

Step  2  -  It  should  be  stressed  that  the  value  reported  in  column  7  is 
calculated  over  the  entire  measurement  period  and  therefore  could  be  biased  by 
periods  of  heavy  or  light  activity.  It  is  for  this  reason  that  the  user  is 
urged  to  run  the  monitor  during  those  periods  of  time  where  the  workload  is 
considered  to  be  heavy  and  constant.  In  order  to  determine  if  the  above  type 
of  biasing  is  occurring,  the  user  may  want  to  check  Plot  #1.  If  it  appears 
that  there  is  a  mixing  of  light  processing  and  heavy  processing  the  user  may 
want  to  re-run  the  data  reduction  program,  using  the  time-frame  option,  to 
separate  the  heavy  processing  time. 

Step  3  -  Calculate  the  ratio  of  column  5  divided  by  column  4.  This  is  an 
indication  of  the  maximum  number  of  user  jobs  that  your  system  can  support  at 
any  one  time,  without  the  occurrence  of  significant  swapping.  If  the  value  in 
column  10  is  equal  to  or  exceeds  this  ratio,  then  the  implication  is  that  the 
system  has  reached  memory  saturation.  If  the  value  in  Column  10  is  within  2 
units  of  the  ratio,  then  the  system  probably  has  sufficient  memory  but  is 
approaching  saturation.  Finally,  if  the  value  in  column  10  is  less  than  the 
ratio  by  more  than  2  units,  the  current  system  has  sufficient  memory. 

Step  4  -  If  column  13  is  less  than  85,  the  current  cysten  sr.culu  nave 
sufficient  memory  and  the  other  steps  should  not  ce  showing  indications  of 
memory  problems.  If  column  13  is  between  85  and  95  then  the  current  system  is 
approaching  saturation  and  at  times  may  be  showing  some  indications  of  a 
backlog.  If  the  figure  exceeds  95,  then  other  steps  should  be  indicating 
signs  of  moderate  to  severe  memory  problems. 

Step  5  -  If  column  8  is  greater  than  or  equal  to  3,  the  indication  is  that 
memory  has  become  a  constraining  factor. 

Step  6  -  If  Column  12  is  greater  than  2,  the  indication  is  that  memory 
wait  time  is  high  and  that  memory  is  probably  a  constraining  factor. 

At  this  point,  the  user  should  have  a  fairly  good  indication  as  to  whether  or 
not  memory  is  a  constraining  factor.  The  following  steps  will  indicate  some 
additional  reports  that  the  user  should  reference  to  determine!  those  jobs  that 
might  be  causing  the  memory  problem. 
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Step  7  -  One  of  the  largest  users  of  resources  are  jobs  that  abort  and 
then  must  be  rerun.  Aborts  usually  occur  due  to  user  errors,  but  hardware 
aborts  are  not  uncommon.  If  management  is  aware  of  aborting  jobs  and  the 
reasons  for  them,  they  can  possibly  save  substantial  system  resources.  The 
Abort  Report  is  described  in  Chapter  6  and  gives  an  indication  of  the  system 
resources  being  wasted  by  aborting  jobs. 

Step  8  -  It  is  important  for  management  to  be  aware  of  jobs  that  are 
either  misusing  system  resources  or  are  requesting  large  amounts  of  system 
resources.  Upon  identifying  such  jobs,  these  jobs  could  be  redesigned, 
scheduled  for  non-peak  processing,  or,  in  the  case  of  wasted  resources,  the 
waste  could  be  eliminated.  The  Excessive  Resource  Report  allows  the  user  to 
uncover  jobs  of  this  type  and  is  described  in  Chapter  6.  When  using  this 
report,  the  following  are  suggested  parameter  values: 

wasted  core  -  5K 

memory  -  either  35K  (WWMCCS  standard)  or  2  times  the  value  in  column  4 
CPU  time  -  15  minutes 
10  time  -  30  minutes 

Step  9  -  By  examining  the  System  Program  Usage  of  Memory  Report,  the  user 
can  determine  those  system  type  jobs  that  are  requiring  memory.  It  is 
possible  that  some  of  the  system  jobs  can  be  eliminated  or  at  least  reduced  in 
size.  This  is  especially  true  for  the  Time  Sharing  Subsystem.  However,  it 
must  be  realized  that  a  limitation  on  Time  Sharing  size  may  adversely  effect 
Time  Sharing  response.  In  many  cases,  if  large  file  transfers  are  being 
processed  during  prime  time,  the  size  of  the  FTS  WIN  subsystem  can  rise  to  70 
or  80K.  By  not  allowing  WIN  file  transfers  to  run  during  prime  time, 
significant  memory  savings  can  result. 

Step  10  -  Memory  problems  may  also  be  occurring  as  a  result  of  jobs  being 
delayed  due  to  CPU  constraints  or  I/O  constraints.  In  these  cases,  jobs  tend 
to  sit  in  memory  due  to  a  lack  of  other  system  resources.  Because  these  jobs 
are  being  delayed,  other  jobs  cannot  enter  memory,  and  memory  demanas  begin  to 
backlog.  Therefore,  if  memory  is  a  constraint,  the  user  should  consider 
conducting  a  CPU  analysis  as  well  as  an  I/O  analysis. 

14.6.4  CPU  Evaluation.  The  CPU  evaluation  will  determine  the  general 
utilization  level  of  the  processor  and  then  determine  if  the  CPU  is  dominated 
by  GCOS  or  user  program  execution.  A  CPU  data  reduction  is  required  for  this 
evaluation.  It  is  also  beneficial  to  have  an  associated  MUM  data  reduction 
available  for  the  same  time  period.  Figures  14-5  and  14-6  are  sample  table 
formats  that  may  be  used  to  display  the  gathered  data. 

14.6.4.1  Data  Recording.  For  Figure  14-5»  data  for  columns  1  and  14  can  be 
obtained  from  the  heading  page.  Data  for  columns  2-8  can  be  obtained  from  the 
last  section  of  the  CPU  Time  Report.  This  report  is  produced  every  10  minutes 
of  elapsed  time  and  the  data  of  interest  should  be  found  in  the  last  10-minute 
report.  Columns  9-13  are  filled  from  Histogram  Reports  1,  2,  5,  6,  9 
respectively.  For  figure  14-6,  the  data  may  be  obtained  directly  from  the 
last  line  of  the  CPU  Plot. 


14-18 


14.6.4.2  Evaluating  the  Data 


Step  1  -  The  CPU  nay  by  considered  a  bottleneck  if  column  7  of  figure  14-5 
is  less  than  20  or  Column  2  of  figure  14-6  is  greater  than  50.  It  is  a -fairly 
agreed  upon  standard  that  average  processor  utilization  should  not  exceed 
80S.  By  maintaining  average  processor  utilization  at  this  level,  the 
processor  will  have  sufficient  remaining  capacity  to  be  able  to  handle  those 
peaks  of  processor  demand  that  normally  occur  during  the  day.  The  three 
category  breakdowns  of  figure  14-6  represent  the  three  conditions  of 
insufficient  power,  sufficient  power,  and  excess  power  respectively. 

Step  2  -  If  column  •/ 6  of  figure  14-5  is  greater  than  (100-column  7  of 
figure  14-5)/2,  then  the  CPU  is  dominated  by  user  activities.  Otherwise  it  is 
dominated  by  system-oriented  functions. 

Step  3  -  Column  8  of  figure  14-5  provides  an  indication  of  the  percentage 
of  CPU  power  being  lost  because  multiple  processors  are  interfering  with  each 
other.  Within  GCOS,  there  are  many  tables  that  must  be  updated  and/or 
referenced  by  a  processor  during  its  execution.  When  these  tables  are  being 
used,  the  processor  must  insure  that  they  are  not  altered  in  any  manner.  In 
order  to  accomplish  this,  the  processor  will  lock  a  gate.  This  locked  gate 
will  prevent  any  other  processor  from  accessing  this  table.  When  the  first 
processor  has  completed  its  use  of  the  table,  the  gate  will  be  opened.  If  a 
processor  must  access  a  gated  table,  it  will  simply  perform  a  “CPU  loop"  at 
that  table,  waiting  for  it  to  be  opened.  The  amount  of  time  being  spent  in 
this  gate  locked-CPU  loop  code  is  depicted  under  column  8. 

Step  4  -  If  step  2  Indicates  that  user  jobs  are  the  predominant  users  of 

the  CPU,  then  the  MUM  Excessive  Resource  Report  can  be  used  to  determine  those 
jobs  requiring  excessive  CPU  resources.  In  addition,  the  CPU  Plot  report  can 
be  used  to  determine  those  times  of  day  when  processor  availability  is  in  the 
critical  range.  Using  these  two  items  of  information,  system  schedular 
classes  can  be  created  based  on  CPU  requirements. 

Step  5  -  Another  indication  that  the  CPU  is  a  bottleneck  can  be  determined 
from  columns  9  and  10  of  figure  14-5.  If  the  sum  of  these  two  columns  exceeds 
Column  14  by  one,  then  jobs  are  being  queued  for  the  CPU.  This  queuing  of 
jobs  at  the  CPU  is  an  indication  that  during  some  period  of  the  day,  there  is 
insufficient  CPU  power  to  handle  the  workload.  Once  again,  the  CPU  Plot  can 
be  used  to  determine  those  periods  of  time. 

Step  6  -  Columns  11  and  12  can  provide  an  indication  that  there  is  an  I/O 

backlog  in  the  system.  If  the  sum  of  these  two  columns  is  close  to  the 

overall  multiprogramming  depth  of  the  system  (determined  from  the  MUM  Reports) 
then  the  indication  is  that  there  is  an  I/O  backlog,  and  an  I/O  analysis 
should  be  conducted. 
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Figure  14-5.  CPU  Program  Characteristics 
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Figure  14-6.  CPU  Processor  Availability 
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14.6.5  I/O  Evaluation.  The  I/O  evaluation  will  determine  whether  the  mass 
storage  subsystem,  or  tape  channel  subsystem  is  the  cause  of  system 
degradation.  This  evaluation  requires  the  user  to  have  processed  the  Mass 
Storage  Mon. tor  and  Channel  Monitor  data  reduction  programs. 

14.6.5*1  Data  Recording.  All  output  from  the  Mass  Store  Monitor  and  Channel 
Monitor  are  required.  No  individual  work  tables  are  required,  but  the  user 
may  generate  some  if  he  feels  that  it  will  help  in  his  analysis. 

14.6.5.2  Evaluating  tne  Data.  Chapters  7  and  8  provide  a  fairly  detailed 
description  of  the  procedure  to  be  followed  in  analyzing  the  associated 
reports.  In  this  section,  reference  will  be  made  to  those  chapters  indicating 
actual  data  values  that  should  be  used  as  a  reference  for  comparison. 

Step  1  -  Analyze  the  Channel  Monitor  Idle  Report.  This  report  can  be 
generated  only  if  the  Idle  Monitor  was  run  in  conjunction  with  the  Channel 
Monitor.  If  the  "%  of  Idle  Time  During  Which  I/O  Was  Active"  value  exceeds 
25>,  then  substantial  benefit  may  be  obtained  by  eliminating  I/O  contention. 
The  above  value  is  an  indication  that  even  though  the  CPU  is  going  idle  (i.e., 
has  no  useful  work  to  perform)  there  really  is  potential  CPU  work  available. 
However,  under  current  conditions,  this  potential  CPU  work  is  being  delayed 
because  of  I/O  contention. 

Even  though  the  above  figure  exceeds  25X,  the  system  may  not  have  sufficient 
CPU  power  available  to  handle  the  increased  work  generated  by  removing  the  I/O 
contention.  Therefore,  the  analyst  should  also  check  that  the  "Average  System 
X  Idle"  figure  exceeds  15%.  If  this  proves  to  be  the  case,  then  removal  of 
any  I/O  contention  should  prove  beneficial.  On  the  other  hand,  if  the  figure 
is  lower  than  15X,  then  removal  of  any  I/O  contention  will  probably  result  in 
additional  CPU  contention.  The  Idle  Report  will  also  indicate  those  devices 
causing  most  of  the  contention.  Make  a  record  of  the  device  numbers. 

Step  2  -  Examine  I/O  queue  length  and  I/O  queue  time  histograms  for 
individual  devices  and  channels.  Queues  greater  than  one  and  queue  times 
greater  than  15  MS  should  be  considered  significant.  Record  those  devices 
with  high  contention. 

Step  3  -  If  certain  devices  have  been  determined  as  bottlenecks  under  the 
procedures  described  in  Steps  1  and  2,  the  Job  Conflict  Report  should  be 
obtained  for  those  devices  following  the  procedures  described  in  Chapter  8. 

Step  4  -  Execute  the  Mass  Store  Monitor  Data  Reduction  Program.  Following 
the  procedure  described  in  Chapter  7  for  monitoring  a  specific  device,  the 
analyst  should  be  able  to  determine  the  exact  files  that  are  causing  the 
contention  found  under  the  earlier  steps. 

I 

Step  5  -  Chapter  7,  section  7.3.  provides  a  detailed  description  of  the 
output  from  the  Mass  Store  Monitor  and  sufficient  information  for  interpreting 
all  MSM  reports.  When  investigating  seek  elongation  problems,  an  average  seek 
of  over  45  cylinders  should  be  considered  significant. 
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Step  6  -  This  step  outlines  procedures  for  relocating  files  identified  as 
candidates  for  file  relocation.  Because  of  automatic  loao-leveiing  activity 
by  the  GCOS  operating  system,  an  analyst  has  only  limited  flexibility  for  the 
placement  of  system,  permanent,  and  temporary  files: 

a.  System  Files.  The  device  name  on  which  a  system  file  is  to  be  placed 
can  be  specified  at  system  startup.  Care  should  be  taxen  to  insure 

that  multiple  nigh-used  system  files  are  not  placed  on  the  same  disk 
device.  If  possible,  separate  high-use  system  files  across  disk 
subsystems.  In  addition,  ensure  that  SSA  Cache  memory  and  FMS  cache  are 
enaoled  to  reduce  disk  I/O  activity  to  certain  system  files. 

b.  Permanent  Files.  The  device  name  for  a  permanent  file  can  be 
specified  at  creation,  whether  through  FMS  or  the  ACCESS  subsystem  of 
Time  Sharing.  Files  can  be  moved  by  changing  their  names,  creating 

a  new  file  with  the  old  name,  and  moving  the  data.  The  new  file  can 
be  created  with  a  DEVICE  specification. 

c.  Temporary  Fij.es.  The  device  name  for  a  temporary  file  can  be  specified 
in  the  second  field  of  the  $FILE  card  in  the  job  control  deck.  Jobs 
wnich  run  frequently  can  have  their  $FILE  cards  changed.  Other  jobs 

can  be  controlled  by  policies  governing  the  use  of  SFILE  cards. 

Additionally,  sites  that  have  different  device  types  may  specify 
preferred  device  types  to  be  used  for  temporary  files.  This  procedure 
will  allow  activities  requiring  disk  storage  to  take  advantage  of  higher 
speed  devices. 

Step  7  -  This  step  identifies  possible  seek  contention  problems 
attributable  to  inadequate  temporary  file  space.  This  procedure  uses  the 
SPUTIL  feature  of  the  GCOS  FMS  facility  and  the  Disk  Fragmentation  Report 
available  at  most  sites.  If  such  a  report  is  not  available,  contact 
CCTC/C751.  It  is  necessary  to  analyze  temporary  disk  capacity  on  all  disk 
units  rather  than  just  the  units  identified  in  previous  tuning  steps.  This 
analysis  is  necessary  because  the  disk  units  exhibiting  high  activity  due  to 
temporary  file  use  often  have  more  available  temporary  space.  The  increased 
utilization  of  these  disk  units  may  be  caused  by  inadequate  temporary  storage 
on  other  disk  devices.  For  this  analysis  a  form  as  shown  in  figure  14-7  may 
prove  useful. 

a.  Report  Values.  The  SPUTIL  Report  contains  the  following  information 
on  each  disk  device:  (1)  device  identification,  (2)  overall  capacity, 

(3)  available  disk  space,  (4)  disk  space  dedicated  to  permanent  storage. 
The  Disk  Fragmentation  Report  contains  additional  information  on  each  disk 
device:  (1)  number  of  disk  fragments,  (2)  average  fragment  size,  (3) 
maximum  fragment  size,  (4)  percentage  distribution  of  fragments  by  size, 
and  (5)  total  fragmented  space. 

b.  Form  Entry.  Enter  the  device  identification  for  each  disk  device  on 
the  Temporary  Storage  Test  Form.  For  each  disk  device  enter:  (1)  the 
LLINK  capacity  as  indicated  by  the  SPUTIL  Report  in  the  Total  Capacity 
column;  (2)  the  temporary  capacity  from  the  SPUTIL  Report  in  the  Temp 
Capacity  column;  (3)  the  number  of  fragments  from  the  Disk  Fragmentation 
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Figure  14-7.  Temporary  Storage  Test  Form 


Report  in  the  Number  of  Fragments  column;  (4)  the  maximum  fragment  size  in 
the  Max  Size  column;  (5)  the  percentage  of  fragments  (1-12  and  13-121, 
respectively)  in  the  Percent  Fragments  column. 


c.  Calculations.  Divide  the  temporary  capacity  of  each  disk  device  by  the 
total  capacity,  and  place  the  result  in  the  "Ratio  1"  column.  Add  the 
Percent  Fragments  1-12  and  the  Percent  Fragments  13-121  columns  and  place 
the  sum  in  the  Total  Percent  column. 

d.  Decision.  Place  a  cnee*  mark  in  the  "Ratio  2"  column  if  the  ratio 
of  temporary  storage  to  total  storage  is  (  .15).  Place  a  check  mark 
in  the  "Fragment  "  column  if  (1)  the  number  of  fragments  is  100,  (2) 
the  maximum  size  of  a  fragment  is  2000,  and  (3)  the  total  percentage  of 
fragments  less  than  121  LLINKS  (10  LINKS  or  less)  is  40. 

Step  8  -  If  devices  have  been  checked  in  Step  6,  then  the  temporary  file 
space  on  these  devices  is  constrained  by  either  (1)  insufficient  file  space 
("Ratio  ")  or  (2)  disk  fragmentation  ("Fragment  "). 

If  a  large  number  of  devices  neea  to  be  checked,  then  overall  temporary  disk 
space  availability  may  be  a  constraint  to  system  performance.  At  this  point  a 
site  should  either  institute  procedures  to  recover  permanent  disk  space 
(purging  of  unused  files)  or  re-evaluate  disk  capacity  relative  to  system 
workload . 

If  certain  disk  devices  have  been  checked  because  of  their  temporary  to  total 
ratio,  or  if  many  devices  have  been  checked  because  of  disk  fragmentation, 
then  the  following  procedures  to  balance  the  file  system  should  be  instituted. 

a.  Fragmentation.  Temporary  disk  space  may  be  compacted  by  a  full  restore 
of  the  file  system  (cold  boot).  The  Disk  Fragmentation  Report,  run  daily, 
could  help  determine  the  frequency  at  which  a  full  file  system  restore 
would  be  necessary. 

b.  Amount  of  Available  Space.  The  full  file  system  restore  redistributes 
permanent  files  to  equalize  the  amount  of  temporary  storage  on  each  pack. 
The  FMS  SPUTILST  Report  should  be  examined  after  the  restore  to  verify 
that  disk  units  have  been  balanced.  Temporary  disk  space  may  still  not 

be  evenly  distributed  if  (1)  users  have  specified  specific  devices  for 
permanent  files  or  (2)  unusually  large  files  are  present  on  certain  disk 
units.  Consider  such  factors  as  intentional  file  placement  for  maximum 
seek  activity  and  operational  requirements  of  data  bases  before  moving 
permanent  files . 

14.6.5.3  Mass  Storage  Operation.  The  following  article  appeared  in  the 
September  19 81  WWMCCS  H6000  World  Magazine.  It  presents  an  excellent 
description  of  disk  operation  and  some  problem  areas  that  a  system  analyst 
should  be  aware  of. 
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"We  won't  discuss  the  gyrations  that  GCOS  performs  in  setting  up  an  I/O 
request;  e.g.,  management  of  PAT  pointers,  PAT  bodies,  etc.  (We  recommend  the 
HIS  GCOS  Analysis  course).  Our  interest  begins  at  the  point  when  an  I/O 
request  generated  by  some  workload  element  is  presented  to  the  I/O  Supervisor 
(IOS)  for  service.  We  don't  care  whether  the  I/O  came  via  GFRC  or  directly 
from  a  MME  GEINOS.  We  do  care  about  the  major  logical/physical  events  from 
this  point  to  I/O  termination  which  are  important  to  understanding  system 
performance . 

"As  an  example,  let's  assume  tnat  we  have  a  dual-channel  micro-programmable 
controller  (MPC)  cross-barred  to  its  disk  devices.  Dual-channel  means  that 
the  MPC  has  two  physical  data  paths  for  transferring  data  to  the  IOM. 
Cross-barred  to  the  device  means  that  there  are  two  physical  paths  from  the 
MPC  to  each  of  its  devices. 

"Let's  also  assume  that  the  IOM  is  cross-barred  at  two-to-one.  IOM 
cross-barring  refers  to  the  logical-physical  hardware  channel  relationship  of 
the  IOM.  This  relationship  is  defined  to  GCOS  in  the  STARTUP  deck  and 
maintained  in  the  Secondary  Configuration  Taole  and  elsewhere.  For  the 
example,  assume  that  PUB  addresses  0-S  and  0-9  are  associated  with  one 
physical  MPC  channel,  and  that  0-10  and  0-11  are  associated  with  the  second 
MPC  channel  as  is  shown  below: 


Figure  1 


"Defined  in  the  STARTUP  deck  is  the  primary  PUB  address  for  the  disk  subsystem 
and  the  order  in  which  logical  paths  will  be  assigned  by  GCOS  during 
processing.  The  card 

$  IOM-O  PUB-8, MS0450.UNITS-6, 

$  ETC  UNIT-1, ST1 


defines  PUB  0-8  as  the  primary  PUB  address  for  a  MSSU51  subsystem.  The  card 

$  XBAR  IOM-O, PUB-8,  PUB-10, PUB-9,  PUB-11 

defines  the  order  in  which  PUB  assignments  will  be  made.  This  information  is 
maintained  by  GCOS  in  the  I/O  stream  table.  All  requests  for  a  device  are 
made  with  its  primary  PUB  address,  e.g.,  an  I/O  request  for  device  6  on  this 
subsystem  would  request  IOM-PUB-DEVICE  =  0-8-6. 

"Suppose  that  IOS  receives  a  request  for  I/O  to  0-8-6.  If  the  device  is 
currently  performing  an  I/O  (i.e.,  busy),  the  I/O  request  is  queued  for  later 
service.  If  the  device  is  free,  IOS  will  assign  a  logical  channel  to  the 
request  if  one  is  available.  It  will  attempt  to  assign  PUb  0-8.  If  0-8  is 
busy,  it  will  attempt  to  assign  0-10,  etc.,  in  the  order  prescribed  on  the 
$  XBAR  card.  If  no  logical  channel  is  available,  the  I/O  request  will  be 
queued  for  later  service  as  before. 

"To  recap,  for  an  1/0  request  to  become  active  (in-service),  both  the 
requested  device  and  a  logical  channel  associated  with  the  MPC  which  controls 
the  device  must  be  free.  Otherwise  the  request  is  placed  in  the  I/O  queue. 
Normally  the  request  will  be  placed  at  the  end  of  the  queue;  i.e.,  behind 
earlier  I/O  requests.  However,  certain  I/O  requests  are  linked  in  front  of 
the  queue,  e.g.,  TSS  requests  for  access  to  its  swap  files  (#S,  #T,  #U,  #V). 
This  can  impact  system  performance  and  will  be  discussed  later. 

"Whether  or  not  our  request  for  I/O  to  0-8-6  becomes  active,  IOS  will  scan  the 
I/O  queue  to  determine  if  any  earlier  I/O  requests  can  now  be  activated 
(device  and  logical  channel  free).  When  an  I/O  request  can  be  activated,  IOS 
loads  the  mailbox  in  Hard  Core  Memory  for  the  logical  channel  and  signals  the 
IOM.  This  mailbox  contains  information  required  by  the  IOM  to  process  the  1/0 
independently  of  the  mainframe  processor.  The  IOM  loads  the  mailbox 
information  into  its  scratch  pad  memory  and  begins  processing  the  physical  I/O. 

"Thus  far,  the  events  which  have  occurred  were  independent  of  the  type  of  disk 
device  involved.  The  three  phases  of  physical  delay  for  a  disk  device  are 
seek  time,  rotational  latency,  and  data  transfer.  The  IOM  issues  a  seek 
request  to  the  MPC  for  0-8-6,  but  now  performance  implications  arise  which 
depend  both  on  the  physical  characteristics  of  the  device,  and  on 
device-dependent  interactions  with  IOS  which  might  be  required. 

"First  let's  look  at  seek  time,  defined  as  the  time  required  to  move  the 
read/write  heads  from  their  current  position  to  the  cylinder  requested  by  the 
current  I/O.  For  a  given  device,  seek  time  is  proportional  to  the  number  of 
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cylinders  traversed.  Table  1  gives  seek  times  for  H6000  disk  devices.  The 
table  provides  sufficient  information  to  derive  the  average  seek  time  for  a 
device  from  the  average  number  of  cylinders  moved  (available  from  MSM). 


Device 

DSS181 

DSS191 

MSU450 

Minimum 

10  ms 

10  ms 

8  ms 

Average 

34  ms 

30  ms 

25  ms 

Maximum 

60  ms 

55  ms 

55  ms 

Cylinder s /pack 

200 

404 

808 

Seek  Specifications 
Table  1 

"Now  that  "seek"  has  been  defined,  we  can  discuss  the  motivation  of 
implementing  the  logical-physical  channel  architecture.  The  disk  subsystem 
can  have  as  many  seeks  and  data  transfers  ongoing  as  there  are  logical 
channels  assigned  to  the  subsystem.  The  number  of  simultaneous  data  transfers 
that  can  be  performed  is  limited  by  the  number  of  physical  channels.  In  our 
example,  we  could  see  two  devices  connected  to  the  physical  channels 
transferring  data  and  two  additional  devices  moving  the  read/write  heads  to 
the  requested  cylinder  (seeking).  Or,  we  could  have  one  data  transfer  ongoing 
with  three  seeks,  or  we  could  have  four  seeks  ongoing,  etc.  So  the  purpose  of 
IOM  cross-barring  is  to  increase  the  simultaneity  or  overlapping  of  device 
seeks . 

"When  the  seek  to  the  requested  cylinder  has  been  completed,  the  device  is 
ready  to  transmit  or  receive  data.  Here  again  a  device-dependent  performance 
consideration  comes  into  play.  For  a  DSS191  or  MSU450  disk  subsystem,  once 
IOS  has  loaded  the  channel  mailboxes  and  signalled  the  IOM,  it  performs  no 
further  service  to  the  I/O  request  until  an  I/O  termination  interrupt  is 
received  for  that  device.  The  determination  of  seek  completion  and  assignment 
of  the  physical  channel  for  the  data  transfer  takes  place  completely  in  the 
MPC.  Not  so  for  the  DSS181  subsystem. 

"The  DSS181  does  not  provide  a  seek  complete  interrupt,  and  so  IOS  must  check 
for  a  seek  complete  status  each  time  it  gets  control  for  an  I/O  request  as 
described  above  or  for  servicing  an  I/O  termination  interrupt.  This 
introduces  another  delay  for  the  181s  from  the  time  seek  completes  until  the 
next  time  IOS  is  activated.  When  IOS  detects  seek  complete  for  a  181,  it  must 
issue  another  command  to  connect  the  physical  channel  and  begin  data  transfer. 

I 

"If  both  of  our  physical  channels  are  busy  transferring  data,  there  is  another 
delay  until  a  physical  channel  is  free.  But  let's  suppose  the  seek  has 
completed,  a  physical  channel  is  available  for  connecting  to  the  device 
(whether  by  the  MPC  or  by  IOS)  and  we  are  ready  to  transfer  data.  Another 
delay  is  imposed  now  due  to  the  rotational  latency  of  the  device.  This  is  the 
time  from  physical  channel  assignment  until  the  requested  sector  rotates  to 
the  read/write  heads.  This  delay  is  a  function  of  the  rotational  velocity  of 
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the  device.  The  minimum  latency  for  a  device  is  always  0.  (The  data  is  at 
the  heads  at  channel  connect  time.)  Maximum  latency  for  a  device  is  the  time 
required  for  1  revolution  of  the  disk,  and  average  latency  is  generally 
defined  as  the  time  required  for  1/2  revolution  (see  Table  2). 


Device 

DSU181 

DSU191 

MSU451 

Rotational 

2400  RPM 

3600  RPM 

3600  RPM 

Speed 

40  RPS 

60  RPS 

60  RPS 

Avg.  Latency 

12.5  ms 

8.3  ms 

8-3  ms 

Max .  Latency 

25  ms 

16.7  ms 

16. 7  ms 

Rotational  Latency 
Table  2 


"A  word  about  Rotational  Positional  Sensing  (RPS).  RPS  is  a  feature  available 
on  some  disk  subsystems  —  a  required  option  (?)  on  MSU451s  —  whicn  keeps  the 
MPC  informed  about  the  rotational  position  of  each  disk.  In  a  situation  where 
the  physical  channel  is  free  and  more  than  one  device  has  completed  it's  seek, 
the  MPC  can  assign  the  physical  channel  to  the  unit  whose  requested  sector  is 
closest  to  the  heads.  The  idea  is  to  reduce  rotational  latency  thereby 
increasing  the  physical  channel  time  which  can  be  utilized  for  data  transfer. 
What  does  RPS  buy  you  if  only  one  disk  unit  has  completed  its  seek  when  the 
physical  channel  is  assigned?  Not  a  thing. 

"Now  that  device  0-8-6  has  been  assigned  the  physical  channel  and  the 
requested  sector  is  under  the  heads,  the  physical  transfer  of  data  begins. 

The  time  to  complete  the  transfer  of  data  depends  on  the  number  of  words  to  be 
transferred,  the  rotational  velocity  of  the  device,  and  the  recording  density 
of  the  media.  Data  transfer  rates  per  second  are  given  in  Table  3. 


Device 

DSU181 

DSU191 

MSU451 

f 

Transfer 

416KC 

1074KC 

1074KC 

^  i 

Rate 

69.33KW 

179KW 

179KW 

KC  =  1000 
KH  s  1000 

-  6  BIT  CHARACTERS 

-  35  BIT  WORDS 

;•  ( 

Data 

Transfer 
Tfcble  3 

Rates 

L 

14-29 

1 


"When  data  transfer  has  completed,  an  I/O  terminate  interrupt  is  issued  to  the 
H6000  CPU  (CPU  0).  The  GCOS  dispatcher  suspends  execution  of  the  program  in 
operation,  performs  a  few  housekeeping  duties  and  then  dispatches  CPU  0  to  the 
disk  channel  module  in  IOS.  A  bit  more  housekeeping  and,  for  our  purposes, 
the  I/O  to  0-8-6  is  complete.  IOS  then  checks  the  I/O ■  queue  for  seeks  to 
start  —  note  that  at  this  point  it  has  a  free  logical  channel,  ana  so  can 
start  at  least  one  seek  if  an  I/O  request  is  pending  against  a  free  device  on 
this  subsystem.  If  a  DSS181  subsystem  is  present,  it  must  also  check  for  a 
seek  complete  status  as  described  above.  When  IOS  can  perform  no  more 
actions,  it  relinquishes  control  to  the  dispatcher. 

"In  terms  of  capacity,  a  DSU1191  can  hold  as  much  data  as  approximately  4.3 
DSU181  packs  (see  Table  4).  A  MSU451  can  store  roughly  2  DSU191  packs  or  8.6 
DSU181  packs  worth  of  data.  In  terms  of  data  transfer  rates,  tne  191s  and 
451s  are  about  2.6  times  faster  than  181s. 


Device 

DSU181 

DSU191 

MSU451 

Char,  per  pack 

27.6mc 

117 .9mc 

235. 8mc 

Device  Capacities 
Table  4 


Here  are  a  few  WATCHITs. 

"WATCHIT  1:  When  replacing  181s  with  451s.  The  vast  capacity  of  the  451s 
make  it  feasible  to  replace  up  to  8  181s  with  a  single  451.  In  a  situation 
where  4  I/Os  were  pending  to  files  resicir. _•  ;r.  4  different  181s  (our  2  to  1 
cross- 

barred  dual  channel  example),  as  opposed  to  the  451,  the  181  configuration 
might  be  preferable.  Although  the  451  is  2.6  times  as  fast,  we  would 
sacrifice  overlapping  of  the  seeks,  and  the  181  subsystem  can  transfer  data 
from  2  of  the  devices  in  parallel.  The  CM  Device  I/O  Queue  Length  Histrogram 
and  the  Channel  Free-Device  Busy  Report  can  indicate  if  a  device  contention 
problem  exists. 

"WATCHIT  2:  When  pondering  vendor  specs  for  18ls.  We  modified  the  MSM  data 
reduction  program  to  obtain  the  average  data  transfer  size  to  each  disk 
device.  MSM  also  provides  the  average  cylinders  seeked  per  I/O  for  each 
device.  Assuming  the  average  rotational  latency,  one  should  be  able  to  use 
the  vendor  specs  provided  in  this  article  to  compute  the  I/O  service  time  for 
a  given  device.  The  I/O  service  time  for  each  device  is  provided  as  a  CM 
report.  For  MSU451s  the  computed  value  matches  the  CM  report  to  within  a  few 
milliseconds.  However  the  181  computed  and  monitored  values  differ  by  as  much 
as  30ms  and  more  —  the  computed  value  always  being  less.  Since  channel 
utilization  is  fairly  low,  the  most  likely  reason  for  this  discrepancy  is  that 
IOS  latency  time  we  discussed  earlier. 

"WATCHIT  3:  When  placing  TSS  swap  files  (#S,  #T,  #U,  #V).  We  mentioned 
earlier  that  TSS  requests  for  access  to  it's  swap  files  were  linked  to  the 
front  of  the  I/O  queue.  TSS  is  not  one  to  wait  on  user  I/Os,  nor  does  it 
break  it's  swap  action  into  nice  little  320-word  standard  system  format  I/Os. 
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It's  gonna  swap  the  whole  thing.  Say,  there's  a  nice  little  TSS  COBOL  sub¬ 
system  —  only  40Kt  Time  to  swap?  So  soon?  Oh  yeah,  that  memory-time 
quantum.  Lot  of  memory  —  not  much  time.  Oh  well,  a  40K  transfer  is  OK.  My 
swap  files  are  on  fast  451s.  Friend,  you  just  tied  up  that  device  for  almost 
a  quarter  of  a  second,  and  more  importantly,  a  physical  channel  as  well. 
That's  only  half  of  it.  TSS  swapped  it  out,  you  can  bet  it'll  swap  it  back 
in.  So  we're  up  to  .5  sec  of  physical  channel  time  to  free  up  some  TSS  user 
memory.  This  scenario  impacts  total  system  throughput,  not  just  TSS.  That's 
not  all  the  havoc  that  larger  user  subsystems  create,  but  that  is  enough 
heartburn  for  now." 


This  page  Intentionally  left  blank 
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